ClickHouse/mcp-clickhouse

これは何？

主な機能

• 01ClickHouseクラスターに対してSQLクエリを実行し、JSON形式の結果を取得できます。
• 02LIKEフィルターを使ってデータベースを一覧表示し、テーブルをページごとに取得できます。
• 03デフォルトは読み取り専用で、書き込みと破壊的操作は個別のフラグで明示的に有効化します。
• 04ClickHouseの{name:Type}プレースホルダーを使ったパラメーター化クエリに対応しています。
• 05オプションのchDBバックエンドにより、ETLなしでファイルやデータソースをクエリできます。
• 06BearerトークンまたはOAuth/OIDC認証を使用するstdio、HTTP、SSEの各トランスポートに対応しています。

ユースケース

• AIアシスタントにテーブルスキーマを探索させ、ClickHouseのデータに関する質問に答えさせる。
• アナリストに、分析データを読み取り専用で扱える対話型インターフェースを提供する。
• アシスタントから組み込みのchDBエンジンを通じて、ローカルファイルやリモートデータソースをクエリする。

クイックスタート

1. 1

   オプションの chDB extra を指定して、PyPI からパッケージをインストールします

   pip install 'mcp-clickhouse[chdb]'
2. 2

   README の説明に従って ClickHouse 接続を設定し、サーバーを起動します

使う前に知っておきたいこと

• !HTTP および SSE トランスポートを使用するには、起動を成功させる前に認証を設定する必要があります。

トピック

よくある質問

mcp-clickhouse とは？

AIアシスタントからClickHouseのスキーマ探索やSQLクエリの実行を可能にするMCPサーバー。デフォルトは読み取り専用です。 mcp-clickhouseは、Claude DesktopなどのAIアシスタントをClickHouseデータベースに接続するModel Context Protocol（MCP）サーバーです。データベースの一覧表示、テーブルのページごとの取得、SQLクエリの実行といったツールを提供し、アシスタントがスキーマを探索したり、ライブデータをもとに分析的な質問に答えたりできます。

mcp-clickhouse は無料で使えますか？ライセンスは？

mcp-clickhouse は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

mcp-clickhouse は今もメンテナンスされていますか？

活発にメンテナンス中。mcp-clickhouse の最終コミットは 2026年10月21日 です。

mcp-clickhouse は何に使えますか？

AIアシスタントにテーブルスキーマを探索させ、ClickHouseのデータに関する質問に答えさせる。 アナリストに、分析データを読み取り専用で扱える対話型インターフェースを提供する。 アシスタントから組み込みのchDBエンジンを通じて、ローカルファイルやリモートデータソースをクエリする。

mcp-clickhouse のインストール方法は？

オプションの chDB extra を指定して、PyPI からパッケージをインストールします: pip install 'mcp-clickhouse[chdb]' README の説明に従って ClickHouse 接続を設定し、サーバーを起動します

mcp-clickhouse はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/ClickHouse/mcp-clickhouse