ClickHouse MCPサーバーとは？

ClickHouse MCPサーバーは、ClickHouseデータベース上で安全なSQLクエリを実行し、データベーステーブルを管理するための軽量ツールです。Model Context Protocol（MCP）を通じて便利なデータアクセスインターフェースを提供します。

ClickHouse MCPサーバーの使い方は？

ClickHouse MCPサーバーを設定して実行するのは数ステップです。簡単なコマンドラインツールを使ってSQLクエリを実行し、データベースとテーブルを一覧表示できます。

ClickHouseデータベースを迅速にアクセスして分析する必要がある企業や開発者に適しています。例えば、データ分析、レポート生成、リアルタイム監視などです。

SQLクエリの実行安全に読み取り専用のSQLクエリを実行し、操作がデータベースに影響を与えないようにします。

すべてのデータベースを一覧表示ClickHouseクラスタ内のすべてのデータベースを簡単に確認できます。

テーブルを一覧表示指定されたデータベース内のすべてのテーブルを一覧表示します。

利点

インストールと設定が容易

安全な読み取り専用クエリをサポート

ClickHouseと深く統合

制限

読み取り専用クエリのみをサポート

ClickHouseサーバー環境が必要

依存関係のインストール

`uv sync`コマンドを実行して必要な依存関係をインストールします。`uv`をまだインストールしていない場合は、公式ドキュメントを参照してインストールしてください。

環境変数の設定

.env.productionファイルにClickHouseの接続情報を追加します。

MCPサーバーの起動

`fastmcp install`コマンドを使ってMCPサーバーを起動します。

ユーザーテーブルのクエリSQLクエリを実行してユーザーテーブルの最初の10件のレコードを取得します。

すべてのデータベースを一覧表示ClickHouseクラスタ内のすべてのデータベースのリストを取得します。

クエリの安全性をどのように確保するのですか？

マルチノードクラスタをサポートしていますか？

MCPサーバーをどのようにアンインストールするのですか？

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

run_select_query
- ClickHouse クラスター上で SQL クエリを実行します。
- 入力：sql (文字列)：実行する SQL クエリ。
- すべての ClickHouse クエリは readonly = 1 で実行され、安全性が確保されます。
list_databases
- ClickHouse クラスター上のすべてのデータベースを一覧表示します。
list_tables
- 指定されたデータベース内のすべてのテーブルを一覧表示します。
- 入力：database (文字列)：データベース名。

⚠️ 重要注意

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

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

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

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

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

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