ClickHouse MCP сервер

ClickHouse MCP сервер

site icon
2025.04.02 0
Go数据库服务数据查询数据库
ClickHouse MCP сервер是一个与ClickHouse数据库交互的MCP兼容服务器。它提供了多种功能,包括获取数据库列表、表列表、表结构以及执行SQL查询等。支持多种传输方式(stdio和SSE),适用于需要与ClickHouse数据库进行高效交互的场景。
View on GitHub

Overview

基本能力

产品定位

ClickHouse MCP сервер是一个与ClickHouse数据库交互的MCP兼容服务器,旨在提供高效、灵活的数据库操作接口。

核心功能

  • 获取数据库列表
  • 获取指定数据库中的表列表
  • 获取指定表的结构(schema)
  • 执行SQL查询并获取结果
  • 支持多种传输方式(stdio和SSE)

适用场景

  • 需要与ClickHouse数据库进行高效交互的应用
  • 需要动态获取数据库和表信息的场景
  • 需要执行复杂SQL查询并获取结果的场景

工具列表

  • get_databases: 获取数据库列表
  • get_tables: 获取指定数据库中的表列表
  • get_schema: 获取指定表的结构
  • query: 执行SQL查询并获取结果

常见问题解答

  • 如何切换传输方式?通过命令行参数 -t-transport 指定传输方式(stdio或SSE)。
  • 如何测试服务?使用 -test 参数启动服务以进入测试模式。

使用教程

使用依赖

  • 需要安装Go语言环境
  • 需要ClickHouse数据库服务

安装教程

  1. 克隆仓库并进入项目目录
  2. 使用以下命令编译项目:
go build -o clickhouse-mcp
  1. 启动服务:
./clickhouse-mcp -url localhost:9000/default -user default -password yourpassword

调试方式

  1. 使用 -test 参数启动服务以进入测试模式:
./clickhouse-mcp -test
  1. 检查日志输出以确认服务运行状态。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。