ClickHouse MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows querying and interacting with ClickHouse databases, providing tools for executing SQL select queries, listing databases, and viewing tables within a database.

ClickHouse MCPサーバー

https://github.com/ClickHouse/mcp-clickhouseに移行しました

ClickHouse 用の MCP サーバー。

特徴

ツール

  • run_select_query
    • ClickHouse クラスターで SQL クエリを実行します。
    • 入力: sql (文字列): 実行する SQL クエリ。
    • すべての ClickHouse クエリは、安全性を確保するためにreadonly = 1で実行されます。
  • list_databases
    • ClickHouse クラスター上のすべてのデータベースを一覧表示します。
  • list_tables
    • データベース内のすべてのテーブルを一覧表示します。
    • 入力: database (文字列): データベースの名前。

構成

: これは一時的な構成プロセスであり、パッケージが公開されると大幅に改善されます。

  1. uv syncを実行して依存関係をインストールします。uvをインストールするにはuvこちらの手順に従ってください。その後、 source .venv/bin/activate実行してください。
  2. ClickHouse 資格情報を使用して.env.productionファイルを設定します。
CLICKHOUSE_HOST=<CLICKHOUSE_HOST> CLICKHOUSE_PORT=<CLICKHOUSE_PORT> CLICKHOUSE_USER=<CLICKHOUSE_USER> CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD>
  1. サーバーをインストールするには、 fastmcp install mcp_clickhouse/mcp_server.py -f .env.productionを実行します。
  2. Claude Desktop を再起動します。

発達

  1. test-servicesディレクトリでdocker compose up -dを実行して ClickHouse クラスターを起動します。
  2. リポジトリのルートにある.envファイルに次の変数を追加します。
CLICKHOUSE_HOST=localhost CLICKHOUSE_PORT=8123 CLICKHOUSE_USER=default CLICKHOUSE_PASSWORD=clickhouse
  1. uv syncを実行して依存関係をインストールします。uvをインストールするにはuvこちらの手順に従ってください。その後、 source .venv/bin/activate実行してください。
  2. 簡単にテストするには、 fastmcp dev mcp_clickhouse/mcp_server.pyを実行して MCP サーバーを起動できます。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

ClickHouse 用の MCP サーバー。

  1. Migrated to https://github.com/ClickHouse/mcp-clickhouse
    1. Features
    2. Configuration
    3. Development
ID: 9292900sx1