MCP Timeplus

🚀 ClickHouse MCP サーバー

ClickHouse 用の MCP サーバーです。このサーバーは、ClickHouse との統合を通じて、MCP プロトコルをサポートし、SQL クエリやその他の操作を実行できます。

✨ 主な機能

• MCP プロトコルをサポートし、ClickHouse との統合を可能にします。
• SQL クエリやその他の ClickHouse 操作の実行をサポートします。

💻 使用例

基本的な使用法

1. SQL クエリの実行

# 例：テーブル内のデータをクエリする
SELECT * FROM table_name;

2. すべてのデータベースをリストする

# 例：すべてのデータベースをリストする
SHOW DATABASES;

3. すべてのテーブルをリストする

# 例：指定されたデータベース内のテーブルをリストする
USE database_name;
SHOW TABLES;

📦 インストール

設定ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.13",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "<clickhouse-host>",
        "CLICKHOUSE_USER": "<clickhouse-user>",
        "CLICKHOUSE_PASSWORD": "<clickhouse-password>"
      }
    }
  }
}

📚 ドキュメント

環境要件

• Python 3.10 以上をインストールしてください。
• ClickHouse データベースをインストールしてください。

クイックスタート（Docker を使用）

# ClickHouse コンテナを起動する
docker-compose up -d

# コンテナに入る
docker exec -it clickhouse bash

設定例

ローカル開発環境

# 必須変数
CLICKHOUSE_HOST=localhost
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=clickhouse

# オプション変数（デフォルト値を上書き）
CLICKHOUSE_SECURE=false  # 8123 ポートを使用
CLICKHOUSE_VERIFY=false

ClickHouse クラウド環境

# 必須変数
CLICKHOUSE_HOST=your-instance.clickhouse.cloud
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=your-password

# オプション変数（安全なデフォルト値を使用）
# CLICKHOUSE_SECURE=true  # 8443 ポートを使用
# CLICKHOUSE_DATABASE=your_database

ClickHouse SQL プレイグラウンド

CLICKHOUSE_HOST=sql-clickhouse.clickhouse.com
CLICKHOUSE_USER=demo
CLICKHOUSE_PASSWORD=
# デフォルトで HTTPS と 8443 ポートを使用

注意事項

• 設定ファイル内の環境変数は、.env ファイルに設定するか、ターミナルで直接設定することができます。
• 本番環境では、データの安全性を確保するために CLICKHOUSE_VERIFY を true に設定してください。

以上の手順に従えば、ClickHouse MCP サーバーを簡単に設定して実行することができます。