894 v0.7.0 更新于 2026-09-21

ClickHouse MCP Server

官方 ClickHouse MCP 服务器,用于查询和探索 ClickHouse 集群及 chDB。

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

安装配置

本地运行(pypi)
{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uvx",
      "args": [
        "mcp-clickhouse"
      ]
    }
  }
}
本地运行(docker)
{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/clickhouse/mcp-clickhouse:0.7.0"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 4 个工具

run_query
在 ClickHouse 集群上执行 SQL 查询,支持参数绑定,默认只读。
list_databases
列出 ClickHouse 集群上的所有数据库。
list_tables
列出指定数据库中的表,支持过滤和分页。
run_chdb_select_query
使用 chDB 内嵌 ClickHouse 引擎执行 SQL 查询。

配合站内内容