mcp-clickhouse

mcp-clickhouseは、ClickHouseクラスター上でSQLクエリを実行するためのMCPサーバーです。データベースやテーブルのリスト表示、chDBの埋め込みOLAPエンジンを利用したクエリ実行が可能で、ETLプロセスなしでデータを直接取得できます。また、ヘルスチェックエンドポイントも提供されています。

GitHubスター

515

ユーザー評価

未評価

お気に入り

0

閲覧数

140

フォーク

105

イシュー

25

インストール方法
難易度
中級
推定所要時間
10-20

インストール方法

インストール方法

前提条件

必要なソフトウェアとバージョン:
Python: 3.10以上
ClickHouse: 最新版

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/ClickHouse/mcp-clickhouse.git
cd mcp-clickhouse

2. 依存関係のインストール

bash
pip install -r requirements.txt

3. Claude Desktop設定

claude_desktop_config.jsonを編集してMCPサーバーを追加:
json
{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": ["run", "--with", "mcp-clickhouse", "--python", "3.10", "mcp-clickhouse"],
      "env": {
        "CLICKHOUSE_HOST": "",
        "CLICKHOUSE_PORT": "",
        "CLICKHOUSE_USER": "",
        "CLICKHOUSE_PASSWORD": "",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

4. サーバーの起動

bash
uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Pythonのバージョンを確認し、依存関係を再インストールしてください。

追加リソース