数据库查询服务

ClickHouse MCP Server 是一个为AI助手提供安全、结构化数据库探索和分析的服务,支持列出表、读取数据和执行SQL查询。

  • by dubin555
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 dubin555/clickhouse_mcp_server

使用说明

ClickHouse MCP服务器

ClickHouse的模型上下文协议(MCP)服务器实现。

该服务器为AI助手提供了一种安全和结构化的方式来探索和分析数据库。它使他们能够通过受控接口列出表、读取数据和执行SQL查询,从而确保负责任的数据库访问。

配置

设置以下环境变量:

CLICKHOUSE_HOST=localhost    
CLICKHOUSE_PORT=8123         
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=CHANGE_TO_YOUR_PASSWORD
CLICKHOUSE_DATABASE=default

或者通过命令行参数:

  • --host 数据库主机
  • --port 数据库端口
  • --user 数据库用户名
  • --password 数据库密码
  • --database 数据库名称

用法

在clickhouse中伪造一些数据

有关详细信息,请检查dev_conibute.md中的SQL。

将您的问题发布到Cline的AI助手

What is the sales volume in each region? Which product is the best - selling?

渐变群

在VSCode、Cline扩展或其他MCP客户端中配置MCP服务器。: 例子:

{
  "mcpServers": {
    "clickhouse": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/clickhouse_mcp_server",
        "run",
        "-m",
        "clickhouse_mcp_server.server"
      ],
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_PORT": "8123",
        "CLICKHOUSE_USER": "default",
        "CLICKHOUSE_PASSWORD": "CHANGE_TO_YOUR_PASSWORD",
        "CLICKHOUSE_DATABASE": "default"
      }
    }
    
  }
}

许可证

APACHE-有关详细信息,请参阅许可证文件。

贡献

有关详细信息,请参阅dev_conibute.md。

先决条件

  • Python与uv包管理器
  • ClickHouse安装
  • MCP服务器依赖关系

致谢

这个库的实现受到了以下三个存储库的启发,并整合了它们的代码,尊重开源精神!

谢谢!