clickhouse-dataops-mcp

clickhouse-dataops-mcp

mcp-name: io.github.Aguantar/clickhouse-dataops-mcp

クエリの最適化、パイプラインのレイテンシ分析、データ品質の監視に対応した、DataOps に特化した ClickHouse 用 MCP サーバーです。

機能

クエリを実行するだけの汎用的な ClickHouse MCP サーバーとは異なり、このサーバーはクエリ最適化アドバイザーとして機能します。

• ch_query — SELECT を実行し、パーティションプルーニングに関する警告を自動で表示します
• ch_explain_query — EXPLAIN に基づいて分析し、最適化の提案を行います
• ch_table_schema — テーブルの包括的なメタデータ（列、キー、パーティション、サンプル）を表示します
• ch_pipeline_latency — CDC パイプラインのセグメント別レイテンシ（p50/p95/p99）を表示します
• ch_data_quality — NULL／重複／欠落を検出し、市場カバレッジをチェックします
• ch_slow_queries — 遅いクエリを検出し、根本原因を診断します
• ch_disk_usage — TTL と最適化の推奨事項を含むディスク分析を行います
• ch_list_tables — 説明が組み込まれたテーブルカタログを表示します

安全性

すべてのクエリは読み取り専用です。DDL／DML 操作は SQL 検証レイヤーでブロックされます。

• ブロック対象：DROP、TRUNCATE、DELETE、ALTER、INSERT、UPDATE、CREATE など
• 複数ステートメントのクエリはブロックされます（; 区切り）
• コメントによるバイパスを防止します（検証前にコメントを削除）
• システムテーブルは許可リストに登録されたものに制限されます
• クエリタイムアウト：30 秒
• 行数制限を適用します

インストール

pip install clickhouse-dataops-mcp

Claude Code での使用方法

.mcp.json に追加してください。

{
  "mcpServers": {
    "clickhouse": {
      "command": "clickhouse-mcp-server",
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_PORT": "8123",
        "CLICKHOUSE_DATABASE": "cdc_pipeline"
      }
    }
  }
}

環境変数

変数	デフォルト値	説明
CLICKHOUSE_HOST	localhost	ClickHouse の HTTP ホスト
CLICKHOUSE_PORT	8123	ClickHouse の HTTP ポート
CLICKHOUSE_USER	default	ClickHouse のユーザー名
CLICKHOUSE_PASSWORD	(empty)	ClickHouse のパスワード
CLICKHOUSE_DATABASE	cdc_pipeline	デフォルトのデータベース
CLICKHOUSE_QUERY_TIMEOUT	30	クエリタイムアウト（秒）

ライセンス

MIT