什麼是ClickHouse MCP 服務器？

ClickHouse MCP 服務器是一個專門設計用於AI助手的安全接口，允許它們通過受控方式訪問ClickHouse數據庫。它可以列出表、讀取數據並執行SQL查詢，從而實現對數據庫的高效探索和分析。

如何使用ClickHouse MCP 服務器？

您需要先安裝並配置ClickHouse MCP服務器，然後在客戶端上設置相應的連接參數。之後，您可以向AI助手發送自然語言問題，它會自動轉換為SQL查詢並在數據庫中執行。

適用場景

適用於希望利用AI助手進行數據分析的企業環境，尤其是需要快速生成洞察報告或優化業務流程的情況。

主要功能

列出數據庫中的表支持通過MCP協議獲取數據庫內所有可用表的列表。

執行SQL查詢允許用戶提交SQL語句並在ClickHouse中運行，返回結構化結果。

安全性增強提供嚴格的權限控制機制，確保AI助手僅能訪問授權的數據。

優勢與侷限性

優勢

簡化AI助手與數據庫交互的過程。

支持複雜的SQL查詢以滿足高級分析需求。

內置安全措施防止未授權訪問。

侷限性

可能需要額外配置才能適配特定業務場景。

依賴於ClickHouse數據庫的正常運行狀態。

如何使用

安裝ClickHouse MCP 服務器

按照官方文檔下載並安裝ClickHouse MCP服務器。

配置環境變量

設置必要的數據庫連接參數，如主機地址、端口及用戶名密碼。

啟動服務器

運行服務器命令以監聽MCP請求。

使用案例

查詢銷售區域的總銷售額AI助手接收到用戶的問題後，將其轉換為SQL查詢並返回結果。

查找最受歡迎的產品根據歷史銷售數據確定最暢銷的產品。

常見問題

如何確保ClickHouse MCP服務器的安全性？

是否支持自定義SQL查詢？

如果遇到連接失敗怎麼辦？

🚀 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"
      }
    }
    
  }
}