🚀 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 密钥。