MCP Server Clickhouse

🚀 ClickHouse 雲 MCP 服務器

本 MCP 服務器為與 ClickHouse 雲 API（v1）進行交互提供了實用工具。它支持對組織和服務進行管理，更多功能正在開發中。

🚀 快速開始

此 MCP 服務器能助力你與 ClickHouse 雲 API（v1）實現交互，可用於管理組織和服務。

✨ 主要特性

• 通過 MCP 工具暴露 ClickHouse 雲 API 端點。
• 使用 ClickHouse OpenAPI Key ID 和 Secret 進行身份驗證，後者可通過環境變量提供。
• 處理 JSON 請求正文和響應。

📦 安裝指南

克隆倉庫並安裝依賴

npm install

構建 TypeScript 代碼

npm run build

執行上述命令後，會創建一個 dist 目錄，其中包含編譯後的 JavaScript 文件。

📚 詳細文檔

配置說明

此服務器需要設置以下環境變量：

• CLICKHOUSE_API_KEY_ID：你的 ClickHouse 雲 API Key ID。
• CLICKHOUSE_API_SECRET：你的 ClickHouse 雲 API Key Secret。
• CLICKHOUSE_API_URL：ClickHouse 雲 API 的基礎 URL（默認為 https://api.clickhouse.cloud），使用 http://localhost:2023 可進行本地開發。

與 Claude Desktop 集成

將以下配置添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "clickhouse": {
      "command": "node",
      "args": [
        "/full/path/to/dist/index.js"
      ],
      "env": {
        "CLICKHOUSE_API_KEY_ID": "key id",
        "CLICKHOUSE_API_SECRET": "key secret",
        "CLICKHOUSE_API_URL": "http://localhost:2023"
      }
    }
  }
}

先決條件

你需要一個 ClickHouse 雲 API 密鑰。