使用
Linux x86_64
需要先準備
- 執行環境:
python>=3.10,<=3.15 - 系統套件:
C compiler (for lz4 on Python 3.15)
uv tool install 'mcp-clickhouse[chdb]'(將 mcp-clickhouse 加入 PATH,含 chDB 附加套件)
uv tool install 'mcp-clickhouse[chdb]'
加進你的 agent
claude mcp add mcp-clickhouse -- mcp-clickhouseClaude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"mcp-clickhouse": {
"command": "mcp-clickhouse",
"args": []
}
}
}在 AI 助理設定中將 mcp-clickhouse 加為 MCP 伺服器;設定 CHDB_ENABLED=true 使用內嵌 chDB 引擎,或填入 ClickHouse 連線資訊來查詢叢集。
它能做什麼
- 用內嵌 chDB 引擎查詢資料已測試
怎麼使用
- 啟動伺服器,開啟 chDB 並關閉 ClickHouse:
CHDB_ENABLED=true CLICKHOUSE_ENABLED=false mcp-clickhouse。 - 將 MCP 用戶端連線到伺服器。
- 請助理以 SELECT 查詢呼叫 run_chdb_select_query 工具,例如
SELECT number, number*2 AS doubled FROM numbers(3)。
- 啟動伺服器,開啟 chDB 並關閉 ClickHouse:
- 在 ClickHouse 上執行 SQL 查詢未測試
- 列出資料庫與資料表未測試
- 預設使用唯讀模式未測試
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 1 項可用
- 可離線使用
適合用來
- 從 AI 助理在 ClickHouse 叢集上執行 SQL 查詢
- 用內嵌 chDB 直接查詢檔案與 URL,免 ETL
- 執行前先估算查詢成本
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月15日
- 版本 0.7.0
MCP 用戶端透過 stdio 連線,列出 1 個工具,呼叫 run_chdb_select_query 也回傳了結果。
測試機器遇到的差異
- README: pip install mcp-clickhouse (base package); run_chdb_select_query requires the optional chdb extra
測試中: 以 uv tool install 'mcp-clickhouse[chdb]' 安裝,讓 chDB 工具可用。未設定 CHDB_ENABLED=true 時只會列出 ClickHouse 工具。 - README: ClickHouse tools need a reachable ClickHouse server (CLICKHOUSE_HOST etc.)
測試中: builds.clickhouse.com 的官方 ClickHouse 執行檔在此沙盒中因 segfault 當掉,沙盒內沒有本機伺服器,因此無法測試 run_query、list_databases 與 list_tables。