ClickHouse云API服务

提供与ClickHouse云API交互的工具,用于管理组织和服务。

  • by alexkorep
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 alexkorep/mcp-server-clickhouse

使用说明

ClickHouse云MCP服务器

此MCP服务器提供与ClickHouse Cloud API(v1)交互的工具。它允许管理组织和服务,其余的是TODO。

特性

  • 通过MCP工具展示ClickHouse Cloud API端点。
  • 使用通过环境变量提供的ClickHouse OpenAPI密钥ID和Secret进行身份验证。
  • 处理JSON请求体和响应。

先决条件

您需要一个ClickHouse Cloud API密钥。

安装

克隆此存储库并安装依赖项:

npm install

构建TypeScript代码:

npm run build

这将创建一个 dist 包含编译的JavaScript文件的目录。

配置

此服务器需要设置以下环境变量:

  • CLICKHOUSE_API_KEY_ID:您的ClickHouse Cloud API密钥ID。
  • CLICKHOUSE_API_SECRET:您的ClickHouse Cloud API密钥秘密。
  • CLICKHOUSE_API_URL:ClickHouse Cloud 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"
      }
    }
  }
}