ClickHouse MCP Serverとは？
ClickHouse MCP Serverは、ClickHouseクラスターに対してSQLを実行するための、ClickHouseによるオープンソースのサーバーです。主なツールは3つで、SQL用のrun_query、list_databases、ページング付きでスキーマの詳細を返すlist_tablesです。run_queryはDESCRIBEとEXPLAIN ESTIMATEも扱うため、エージェントはクエリを実行する前に出力と推定読み取り量を確認できます。バージョン0.7.0（2026年9月21日）からは名前付きのクエリパラメータも受け付けます。任意のchDBツールは、ClickHouseの組み込みエンジンでファイルやURLに対してSQLを実行します。
PyPIからインストールし（uvx mcp-clickhouse）、CLICKHOUSE_HOSTなどの接続情報を環境変数に設定します。初期状態ではstdioで動作し、HTTPやSSEでも動きます。HTTPとSSEでは、ベアラートークン、OAuthまたはOIDCのプロバイダー、明示的なオプトアウトのいずれかがないと起動しません。
ClickHouse Cloudの顧客には2つ目の選択肢があります。https://mcp.clickhouse.cloud/mcpのマネージド型リモートサーバーで、読み取り専用のツールが13あり、OAuthかAPIキーでサインインし、Cloudコンソールでサービスごとに有効にします。オープンソースのリポジトリはGitHubのスターが約890で、Apache 2.0ライセンスです。
ClickHouse MCP Serverのインストール方法
uvx mcp-clickhouseClickHouse MCP Serverは使う価値があるか？
分析の作業では、ツールが少ないことは強みです。エージェントはデータベースとテーブルを一覧にし、EXPLAIN ESTIMATEでクエリが何行、何パートを読むかを確認してから実行します。読み取り専用モードが初期設定で、SQLの解析ではなくClickHouse自体のreadonly=1によって強制されます。書き込みを有効にするにはCLICKHOUSE_ALLOW_WRITE_ACCESSが必要で、DROP、TRUNCATE、DELETE 、UPDATEにはさらに2つ目のフラグCLICKHOUSE_ALLOW_DROPが必要です。
セキュリティに関する記述は珍しいほど丁寧です。HTTPモードは認証なしでは起動しません。READMEは、インストールされたパッケージより上の階層のどこかにある.envファイルが認証設定を変えうること、読み取り専用ユーザーでも同じユーザーとして実行中の他のクエリをキャンセルできること、値がクエリログに残りうるためパラメータバインディングはプライバシー機能ではないことを警告しています。破壊的操作のチェックは事故を防ぐためのもので、本当の境界はClickHouseの権限付与だとはっきり書いています。
欠けているのは結果サイズの制限です。クエリは初期状態で30秒でタイムアウトしますが、未解決のissueでは、300万行のSELECTがその時間内に231 MiBのペイロードを返したと報告されています。どのモデルのコンテキストもあふれさせる量です。提案されている上限が導入されるまでは、LIMITを付ける習慣、データベースユーザーへのmax_result_rowsの設定、ミドルウェアのいずれかで対処します。
ClickHouseにはホスト型の選択肢がないという以前の記述は、もう当てはまりません。ClickHouse Cloudのマネージド型エンドポイントは、サービス、バックアップ、ClickPipes、31日間の組織コストの照会のための読み取り専用ツールを加えており、インストールは不要です。セルフマネージドのクラスター、chDB、自分たちの管理下で書き込みアクセスを使いたいチームには、引き続きオープンソースのサーバーが向いています。
真価を発揮する場面
ClickHouse Cloudを使う50人規模のEC企業のプロダクトアナリスト
SQLを書かずに、注文やファネルについてのその場の質問に答える
専用のClickHouseユーザーでClaudeを読み取り専用のサーバーに接続し、エージェントにテーブルを一覧させ、各SELECTの前にEXPLAIN ESTIMATEを実行させます。サーバーは無料で、クエリはCloudサービスのコンピュートとして課金されます。AWS us-east-1のEnterpriseではユニット時間あたり約$0.39からです。
Kubernetes上でセルフマネージドのClickHouseを運用するデータ基盤エンジニア
複数の社内エージェントに、認証付きでデータウェアハウスへの共有アクセスを与える
FastMCPを通じてOIDCプロバイダー付きのHTTPでmcp-clickhouseを動かし、書き込みはオフのままにして、テナントごとの設定を行うミドルウェアを加えます。テナントの分離は、やはりClickHouseのユーザーとロールで実現する必要があります。
ノートPCでParquetファイルを扱うデータサイエンティスト
データベースに読み込まずに、ローカルとリモートのファイルにSQLでクエリを実行する
mcp-clickhouse[chdb]をインストールしてrun_chdb_select_queryを有効にします。組み込みエンジンがファイルとURLを直接読みます。サーバーもCloudの請求もありませんが、chDBのクエリには、エンジンが許す範囲以外にMCP側の書き込み保護がありません。
導入前に確認すること
- 導入
- クライアントの設定にCLICKHOUSE_HOST、CLICKHOUSE_USER、CLICKHOUSE_PASSWORDを入れてuvx mcp-clickhouseを使います。Claude Desktopなどのstdioクライアント向けに文書化されています。ClickHouse Cloudのユーザーは、代わりにサービスでMCPを有効にし、クライアントをhttps://mcp.clickhouse.cloud/mcpに向けることもできます。
- 連携
- 3つのツール（run_query、list_databases、list_tables）と、任意のrun_chdb_select_queryがあります。run_queryは書き込みを有効にしない限り読み取り専用です。FastMCPのミドルウェアで呼び出しを横取りし、ログ記録やユーザーごとの設定を行えます。
- データとプライバシー
- サーバーはClickHouseユーザーに付与されたものなら何でも読めるため、最小権限の専用ユーザーを使ってください。サーバーは手元のマシンで動き、データベースがClickHouse Cloud上にない限り、ClickHouse社には何も送られません。クエリパラメータはClickHouseのクエリログに残ることがあります。
- 大規模利用時のコスト
- サーバーは無料です。ClickHouse Cloud Enterpriseでは、リージョンにより、コンピュートがユニット時間（8 GiB、2 vCPU）あたり$0.33〜$0.52、ストレージが1 TB・月あたり$22〜$27.50です。EXPLAIN ESTIMATEを使わずにスキャンするエージェントは、アイドル中のサービスを起こしてコンピュートを消費することがあります。
- 制限
- 既定のクエリタイムアウトは30秒、ワーカースレッドは10です。返される行数に上限はなく（issue #223）、管理用ツールも組み込みのマルチユーザーモードもありません。ホスト型Cloudサーバーの請求ツールは、1回のクエリで最大31日分までです。
良い点
- 初期状態で読み取り専用で、サーバー側でreadonly=1により強制される
- DROP、TRUNCATE、DELETE、UPDATEは別途オプトインが必要
- EXPLAIN ESTIMATEで、エージェントが実行前にコストを確認できる
- HTTPモードにはトークンかOAuth/OIDCが必要
気になる点
- 結果サイズに上限がなく、大きなSELECTでコンテキストがあふれうる
- 自分で動かすサーバーにはPythonとuvが必要
- ClickHouseの権限付与以外に、マルチユーザーやテナントの分離がない
- Cloudのホスト型サーバーは別の読み取り専用の製品
おすすめの人
安全な初期設定のもとで、ClickHouseのデータからエージェントに質問へ答えさせたいデータチームです。
ClickHouse MCP Serverの代替
ClickHouse MCP Server：よくある質問
- ClickHouse MCP Serverは使う価値があるか？
- ツールが3つで初期状態が読み取り専用なので、結果のサイズを自分で制限するなら、分析エージェントに最初に与えるデータベースサーバーとして安全です。 評価は5点満点中4.2点です。
- ClickHouse MCP Serverの料金は？
- 無料で、Apache-2.0ライセンスです。ClickHouse Cloudは別料金で（Enterpriseのコンピュートは8 GiBのユニット時間あたり約$0.33から）、$300分のクレジット付きの30日間トライアルがあります。
- ClickHouse MCP Serverの欠点は？
- 結果サイズに上限がなく、大きなSELECTでコンテキストがあふれうる; 自分で動かすサーバーにはPythonとuvが必要; ClickHouseの権限付与以外に、マルチユーザーやテナントの分離がない; Cloudのホスト型サーバーは別の読み取り専用の製品.
- ClickHouse MCP Serverは誰に向いているか？
- 安全な初期設定のもとで、ClickHouseのデータからエージェントに質問へ答えさせたいデータチームです。
- チームや本番環境でClickHouse MCP Serverを使うと費用はいくらか？
- サーバーは無料です。ClickHouse Cloud Enterpriseでは、リージョンにより、コンピュートがユニット時間（8 GiB、2 vCPU）あたり$0.33〜$0.52、ストレージが1 TB・月あたり$22〜$27.50です。EXPLAIN ESTIMATEを使わずにスキャンするエージェントは、アイドル中のサービスを起こしてコンピュートを消費することがあります。
- ClickHouse MCP Serverは企業データを扱っても安全か？
- サーバーはClickHouseユーザーに付与されたものなら何でも読めるため、最小権限の専用ユーザーを使ってください。サーバーは手元のマシンで動き、データベースがClickHouse Cloud上にない限り、ClickHouse社には何も送られません。クエリパラメータはClickHouseのクエリログに残ることがあります。
- ClickHouse MCP Serverの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はSnowflake-managed MCP Server, MCP Toolbox for Databases 、 Grafana MCP Serverです。
回答確認日：2026年10月23日