ClickHouse MCPサーバー

https://github.com/ClickHouse/mcp-clickhouseに移行しました

ClickHouse 用の MCP サーバー。

特徴

ツール

• run_select_query

  • ClickHouse クラスターで SQL クエリを実行します。

  • 入力: sql (文字列): 実行する SQL クエリ。

  • すべての ClickHouse クエリは、安全性を確保するためにreadonly = 1で実行されます。

• list_databases

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

• list_tables

  • データベース内のすべてのテーブルを一覧表示します。

  • 入力: database (文字列): データベースの名前。

Related MCP server: mcp-clickup

構成

注: これは一時的な構成プロセスであり、パッケージが公開されると大幅に改善されます。

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

4. 簡単にテストするには、 fastmcp dev mcp_clickhouse/mcp_server.pyを実行して MCP サーバーを起動できます。