什麼是ClickHouse MCP 服務器？

ClickHouse MCP 服務器是一個輕量級工具，用於在ClickHouse數據庫上執行安全的SQL查詢和管理數據庫表。它通過Model Context Protocol（MCP）提供便捷的數據訪問接口。

如何使用ClickHouse MCP 服務器？

只需幾步即可設置和運行ClickHouse MCP服務器。您可以通過簡單的命令行工具執行SQL查詢、列出數據庫和表。

適用於需要快速訪問和分析ClickHouse數據庫的企業和開發者，例如數據分析、報表生成和即時監控。

執行SQL查詢安全地執行只讀SQL查詢，確保操作不會對數據庫造成影響。

列出所有數據庫輕鬆查看ClickHouse集群中的所有數據庫。

列出表列出指定數據庫中的所有表。

優勢

易於安裝和配置

支持安全的只讀查詢

與ClickHouse深度集成

侷限性

僅支持只讀查詢

需要ClickHouse服務器環境

安裝依賴

運行`uv sync`命令來安裝所需的依賴項。如果您尚未安裝`uv`，請參考官方文檔進行安裝。

配置環境變量

在`.env.production`文件中添加ClickHouse的連接信息。

啟動MCP服務器

使用`fastmcp install`命令啟動MCP服務器。

查詢用戶表執行SQL查詢以獲取用戶表中的前10條記錄。

列出所有數據庫獲取ClickHouse集群中的所有數據庫列表。

如何確保查詢的安全性？

是否支持多節點集群？

如何卸載MCP服務器？

ClickHouse MCP 服務器提供了一系列工具，可在 ClickHouse 集群上執行 SQL 查詢、列出數據庫和表等操作。通過簡單的配置步驟，你可以快速安裝並使用該服務器，同時也支持開發環境的搭建與測試。

run_select_query
- 功能：在你的 ClickHouse 集群上執行 SQL 查詢。
- 輸入：sql (字符串)，即要執行的 SQL 查詢。
- 安全保障：所有 ClickHouse 查詢都會以 readonly = 1 運行，確保它們是安全的。
list_databases
- 功能：列出你的 ClickHouse 集群上的所有數據庫。
list_tables
- 功能：在指定數據庫中列出所有表。
- 輸入：database (字符串)，即數據庫名稱。

⚠️ 重要提示

這是一個臨時的配置流程，一旦包發佈將會得到顯著改進。

安裝依賴項：運行 uv sync 來安裝依賴項。要安裝 uv 請按照此處的說明進行操作。然後執行 source .venv/bin/activate。
設置憑據文件：使用 ClickHouse 憑據設置 .env.production 文件：

CLICKHOUSE_HOST=<CLICKHOUSE_HOST>
CLICKHOUSE_PORT=<CLICKHOUSE_PORT>
CLICKHOUSE_USER=<CLICKHOUSE_USER>
CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD>

安裝服務器：運行 fastmcp install mcp_clickhouse/mcp_server.py -f .env.production 來安裝服務器。
重啟應用：重啟 Claude Desktop。

啟動 ClickHouse 集群：在 test-services 目錄下運行 docker compose up -d 以啟動 ClickHouse 集群。
配置環境變量：將以下變量添加到根目錄的 .env 文件中：

CLICKHOUSE_HOST=localhost
CLICKHOUSE_PORT=8123
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=clickhouse

安裝依賴項：運行 uv sync 來安裝依賴項。要安裝 uv 請按照此處的說明進行操作。然後執行 source .venv/bin/activate。
啟動 MCP 服務器：為了方便測試，可以運行 fastmcp dev mcp_clickhouse/mcp_server.py 來啟動 MCP 服務器。