MCP Server Clickhouse

🚀 ClickHouse クラウド MCP サーバー

この MCP サーバーは、ClickHouse クラウド API（v1）とのやり取りを可能にするツールを提供します。組織とサービスの管理が可能で、その他の機能は開発中です。

✨ 主な機能

• MCP ツールを通じて ClickHouse クラウド API エンドポイントを公開します。
• ClickHouse OpenAPI の Key ID と Secret を使用して認証を行い、Secret は環境変数で提供できます。
• JSON 形式のリクエストとレスポンスを処理します。

📦 インストール

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

npm install

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

npm run build

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

📚 ドキュメント

前提条件

ClickHouse クラウド API キーが必要です。

設定

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

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