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 助手提出你的问题

每个地区的销售额是多少？哪个产品最畅销？

<img src="pics/demo.png" alt="Demo Screenshot" width="600" />

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。

前提条件

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

鸣谢

本库的实现灵感来自以下三个仓库，并融入了他们的代码，致敬开源精神！

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

谢谢！