MCP Clickhouse

🚀 ClickHouse MCP サーバー

ClickHouse MCP サーバーは、ClickHouse クラスターに対する操作を容易にするツールです。SQL クエリの実行やデータベース、テーブルの一覧表示などの機能を提供します。

✨ 主な機能

ツール

• run_select_query

  • ClickHouse クラスター上で SQL クエリを実行します。
  • 入力：sql (文字列)：実行する SQL クエリ。
  • すべての ClickHouse クエリは readonly = 1 で実行され、安全性が確保されます。

• list_databases

  • ClickHouse クラスター上のすべてのデータベースを一覧表示します。

• list_tables

  • 指定されたデータベース内のすべてのテーブルを一覧表示します。
  • 入力：database (文字列)：データベース名。

📦 インストール

⚠️ 重要注意

これは一時的な設定手順です。パッケージがリリースされると大幅に改善されます。

1. uv sync を実行して依存関係をインストールします。uv をインストールするには こちら の手順に従ってください。その後、source .venv/bin/activate を実行します。

2. ClickHouse の資格情報を使用して .env.production ファイルを設定します。

CLICKHOUSE_HOST=<CLICKHOUSE_HOST>
CLICKHOUSE_PORT=<CLICKHOUSE_PORT>
CLICKHOUSE_USER=<CLICKHOUSE_USER>
CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD>

3. fastmcp install mcp_clickhouse/mcp_server.py -f .env.production を実行してサーバーをインストールします。

4. Claude Desktop を再起動します。

🔧 開発

1. test-services ディレクトリで docker compose up -d を実行して、ClickHouse クラスターを起動します。

2. 以下の変数をルートディレクトリの .env ファイルに追加します。

CLICKHOUSE_HOST=localhost
CLICKHOUSE_PORT=8123
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=clickhouse

3. uv sync を実行して依存関係をインストールします。uv をインストールするには こちら の手順に従ってください。その後、source .venv/bin/activate を実行します。

4. テストを容易にするために、fastmcp dev mcp_clickhouse/mcp_server.py を実行して MCP サーバーを起動します。