ClickHouse MCP Server

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 (文字列): データベースの名前。

構成

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

1. uv syncを実行して依存関係をインストールします。uvをインストールするにはuvこちらの手順に従ってください。その後、 source .venv/bin/activate実行してください。
2. ClickHouse 資格情報を使用して.env.productionファイルを設定します。

3. サーバーをインストールするには、 fastmcp install mcp_clickhouse/mcp_server.py -f .env.productionを実行します。
4. Claude Desktop を再起動します。

発達

1. test-servicesディレクトリでdocker compose up -dを実行して ClickHouse クラスターを起動します。
2. リポジトリのルートにある.envファイルに次の変数を追加します。

3. uv syncを実行して依存関係をインストールします。uvをインストールするにはuvこちらの手順に従ってください。その後、 source .venv/bin/activate実行してください。
4. 簡単にテストするには、 fastmcp dev mcp_clickhouse/mcp_server.pyを実行して MCP サーバーを起動できます。