← 返回目录

MCP ClickHouse

官方

将 ClickHouse 连接到您的 AI 助手

GitHub 源仓库 ↗

★ 859 Stars 分类 · 数据库非常热门源版本 18a6364332b8

79FMRS · B

可靠性

12/20

安全与权限

18/20

维护活跃度

17/20

文档质量

17/20

安装易用性

15/20

官方 MCP 服务器，功能完善，但需注意权限配置和安全性。

查看 FMRS 评分方法 →

官方 ClickHouse MCP 服务器，用于查询和探索 ClickHouse 集群和 chDB。通过 MCP 提供 SQL 查询、数据库和表列表等工具。

工具能力

run_query

在 ClickHouse 集群上执行 SQL 查询。默认只读。

list_databases

列出 ClickHouse 集群上的所有数据库。

list_tables

列出数据库中的表，支持分页和过滤。

run_chdb_select_query

使用 chDB 的嵌入式 ClickHouse 引擎执行 SELECT 查询。

安装接入

安装依赖：uv 或 Python。
在 Claude Desktop 配置文件中添加 mcpServers 条目（见 install_config）。
设置环境变量 CLICKHOUSE_HOST, CLICKHOUSE_USER, CLICKHOUSE_PASSWORD。
重启 Claude Desktop。

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "<clickhouse-host>",
        "CLICKHOUSE_PORT": "<clickhouse-port>",
        "CLICKHOUSE_USER": "<clickhouse-user>",
        "CLICKHOUSE_PASSWORD": "<clickhouse-password>",
        "CLICKHOUSE_ROLE": "<clickhouse-role>",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

已经使用 ClickHouse 并希望通过 MCP 让 AI 助手直接访问数据的团队。
需要快速、只读的数据查询和数据库探索场景。

不适合谁

需要数据库写入权限且未显式开启写访问的场景。
对安全性要求极高，不希望使用默认权限配置的生产环境。

所需权限

需要 ClickHouse 数据库的只读访问权限（默认）。
可选：通过 CLICKHOUSE_ALLOW_WRITE_ACCESS 启用写入权限。
可选：通过 CLICKHOUSE_ALLOW_DROP 启用破坏性操作权限。

风险与副作用

如果启用写入权限，AI 可能执行意外修改。
如果启用 DROP 权限，可能误删数据。
凭据可能通过环境变量暴露。

常见排障

检查 CLICKHOUSE_SECURE 和 CLICKHOUSE_PORT 是否匹配。
确保 CLICKHOUSE_PORT 是 HTTP 端口 (8123/8443)，而非 native TCP 端口 (9000/9440)。
查看服务器日志以获取详细错误信息。
确认 ClickHouse 服务可达且凭据正确。

使用场景

让 AI 助手直接查询 ClickHouse 数据库以回答数据相关问题。

探索数据库结构，如表和数据库列表。

使用 chDB 进行本地数据分析，无需额外数据库。

支持客户端

Claude Desktop完整支持