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 查询。