ClickHouse Cloud MCP Server

ClickHouse Cloud MCP サーバー

この MCP サーバーは、ClickHouse Cloud API（v1）とやり取りするためのツールを提供します。組織とサービスを管理できます。それ以外は今後対応予定です。

機能

• ClickHouse Cloud API エンドポイントを MCP ツールとして公開します。
• 環境変数で指定された ClickHouse OpenAPI Key ID と Secret を使用して認証します。
• JSON リクエストボディとレスポンスを処理します。

前提条件

ClickHouse Cloud API Key が必要です。

インストール

このリポジトリをクローンし、依存関係をインストールします。

npm install

TypeScript コードをビルドします。

npm run build

これにより、コンパイル済みの JavaScript ファイルを含む dist ディレクトリが作成されます。

設定

このサーバーでは、次の環境変数を設定する必要があります。

• CLICKHOUSE_API_KEY_ID：ClickHouse Cloud API Key ID です。
• CLICKHOUSE_API_SECRET：ClickHouse Cloud API Key Secret です。
• 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"
      }
    }
  }
}