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_contribute.md 中的 SQL。

在 Cline 中向 AI 助手提问

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

CLINE

在 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——详情请参阅 LICENSE 文件。

参与贡献

详情请查看 dev_contribute.md。

先决条件

• Python 和 uv 包管理器
• ClickHouse 安装
• MCP 服务依赖项

致谢

此库的实现受到以下三个代码仓库的启发，并采用了它们的代码，谨此致敬开源精神！

• GreptimeTeam/greptimedb-mcp-server
• ktanaka101/mcp-server-duckdb
• designcomputer/mysql_mcp_server)

谢谢！