ClickHouse MCP Server
ClickHouse MCPサーバーでClaude連携・データ分析を自動化
uvx mcp-clickhouse概要
ClickHouse MCP Serverの設定方法と使い方。
高速OLAPデータベース「ClickHouse」をClaudeから操作できる公式MCPサーバー。
SQLクエリの実行・データベース・テーブル一覧の取得・大量データの分析が可能。
ClaudeとClickHouseのMCPサーバー連携により、自然言語でのデータ分析・クエリ作成・レポート生成を自動化できる。
デフォルトは読み取り専用モードで安全にアクセスでき、設定変更で書き込みも可能。
設定方法は接続情報を環境変数に設定するだけでシンプルに完結する。
料金・APIキー情報
APIキー
🔑 必要🔑 APIキーの取得方法
- 1
https://clickhouse.cloud にアクセスしてアカウントを作成またはログインする
- 2
ダッシュボードからサービスを選択または新規作成する
- 3
サービス詳細画面の「Connect」タブからホスト名・ポート・ユーザー情報を確認する
- 4
パスワードはサービス作成時に設定したものを使用する（再発行は「Reset password」から可能）
こんな使い方ができます
ClaudeにClickHouseデータベースのSQLクエリを自然言語で実行させられる
テーブルのスキーマをClaudeに読み込ませてデータ構造を分析できる
大量ログデータをClaudeで集計・可視化・レポート化できる
複数テーブルを結合したクエリをClaudeが自動生成・実行できる
セットアップ手順
- 1
ClickHouseアカウントにログインし、接続情報（ホスト・ユーザー・パスワード）を確認する
- 2
Pythonの仮想環境ツール「uv」をインストールする（pip install uv）
- 3
claude mcp add clickhouse -e CLICKHOUSE_HOST=your-host.clickhouse.cloud -e CLICKHOUSE_PORT=8443 -e CLICKHOUSE_USER=default -e CLICKHOUSE_PASSWORD=your-password -e CLICKHOUSE_SECURE=true -- uvx mcp-clickhouse
設定ファイル
コピー前に確認
ClickHouseアカウントおよびデータベース接続情報（ホスト・ユーザー・パスワード）必須。uvコマンドのインストールも必要（pip install uv）。
claude mcp add clickhouse -e CLICKHOUSE_HOST=your-host.clickhouse.cloud -e CLICKHOUSE_PORT=8443 -e CLICKHOUSE_USER=default -e CLICKHOUSE_PASSWORD=your-password -e CLICKHOUSE_SECURE=true -- uvx mcp-clickhouse