ClickHouse MCP Server

ClickHouse MCP サーバー

ClickHouse 用に実装された Model Context Protocal（MCP）サーバーです。

このサーバーは、AI アシスタントがデータベースを安全かつ構造化された方法で調査、分析できるようにします。制御されたインターフェースを通じて、テーブルの一覧表示、データの読み取り、SQL クエリの実行を可能にし、責任あるデータベースアクセスを実現します。

設定

次の環境変数を設定します。

CLICKHOUSE_HOST=localhost    
CLICKHOUSE_PORT=8123         
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=CHANGE_TO_YOUR_PASSWORD
CLICKHOUSE_DATABASE=default

または、コマンドライン引数を使用します。

• --host データベースのホスト
• --port データベースのポート
• --user データベースのユーザー名
• --password データベースのパスワード
• --database データベース名

使用方法

ClickHouse にテストデータを作成する

詳細については、dev_contribute.md の SQL を確認してください。

Cline で AI アシスタントに質問する

What is the sales volume in each region? Which product is the best - selling?

CLINE

VSCode、Cline 拡張機能、またはその他の MCP クライアントで MCP サーバーを設定します。: 例：

{
  "mcpServers": {
    "clickhouse": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/clickhouse_mcp_server",
        "run",
        "-m",
        "clickhouse_mcp_server.server"
      ],
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_PORT": "8123",
        "CLICKHOUSE_USER": "default",
        "CLICKHOUSE_PASSWORD": "CHANGE_TO_YOUR_PASSWORD",
        "CLICKHOUSE_DATABASE": "default"
      }
    }
    
  }
}

ライセンス

APACHE - 詳細については LICENSE ファイルを参照してください。

貢献

詳細については、dev_contribute.md を参照してください。

前提条件

• uv パッケージマネージャーを使用する Python
• ClickHouse のインストール
• MCP サーバーの依存関係

謝辞

このライブラリの実装は、次の 3 つのリポジトリに着想を得ており、それらのコードを取り入れています。オープンソースの精神に敬意を表します！

• GreptimeTeam/greptimedb-mcp-server
• ktanaka101/mcp-server-duckdb
• designcomputer/mysql_mcp_server)

ありがとうございます！