Clickhouse MCP Server

🚀 ClickHouse MCP 服務器

ClickHouse MCP 服務器是為 ClickHouse 實現的一個模型上下文協議 (MCP) 服務器，它為 AI 助手提供了安全且結構化的數據庫探索和分析方式。通過受控接口，AI 助手可以列出表格、讀取數據並執行 SQL 查詢，確保了負責任的數據庫訪問。

🚀 快速開始

配置

你可以通過設置環境變量或使用命令行參數來配置服務器。

環境變量配置

設置以下環境變量：

CLICKHOUSE_HOST=localhost    
CLICKHOUSE_PORT=8123         
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=CHANGE_TO_YOUR_PASSWORD
CLICKHOUSE_DATABASE=default

命令行參數配置

使用以下命令行參數：

• --host：數據庫主機
• --port：數據庫端口
• --user：數據庫用戶名
• --password：數據庫密碼
• --database：數據庫名稱

使用方法

假設一些 ClickHouse 中的數據

請參考 dev_contribute.md 文件中的 SQL 語句。

在 Cline 中向 AI 助手提問

What is the sales volume in each region? Which product is the best - selling?

CLINE

在 VSCode、Cline 擴展或其他 MCP 客戶端中配置 MCP 服務器，示例如下：

{
  "mcpServers": {
    "clickhouse": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/clickhouse_mcp_server",
        "run",
        "-m",
        "clickhouse_mcp_server.server"
      ],
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_PORT": "8123",
        "CLICKHOUSE_USER": "default",
        "CLICKHOUSE_PASSWORD": "CHANGE_TO_YOUR_PASSWORD",
        "CLICKHOUSE_DATABASE": "default"
      }
    }
    
  }
}

📄 許可證

本項目採用 APACHE 許可證，有關詳細信息，請參閱 LICENSE 文件。

👥 貢獻

請查閱 dev_contribute.md 以獲取詳細的貢獻信息。

先決條件

• 帶有 uv 包管理器的 Python
• ClickHouse 安裝
• MCP 服務器依賴項

🙏 致謝

這個庫的實現靈感來自於以下三個倉庫，並借鑑了它們的代碼，在此向它們表示感謝，尊重開源精神！

• GreptimeTeam/greptimedb-mcp-server
• ktanaka101/mcp-server-duckdb
• designcomputer/mysql_mcp_server