Clickhouse MCPサーバー

Clickhouse データベース MCP サーバープロジェクト。

インストール

uvを使用してパッケージをインストールできます。

uv pip install clickhouse-mcp-server

またはpipを使用します:

pip install clickhouse-mcp-server

コンポーネント

ツール

サーバーは次の 2 つのツールを提供します。

connect_database : 特定のClickhouseデータベースに接続します
- databaseパラメータ: 接続するデータベースの名前（文字列）
- 接続が成功すると確認メッセージを返します
execute_query : Clickhouseクエリを実行する
- queryパラメータ: 実行する SQL クエリ (文字列)
- クエリ結果をJSON形式で返します
- 複数のクエリはセミコロンで区切って送信できます

構成

サーバーは次の環境変数を使用します。

CLICKHOUSE_HOST : Clickhouseサーバーのアドレス（デフォルト: "localhost"）
CLICKHOUSE_USER : Clickhouse のユーザー名 (デフォルト: "root")
CLICKHOUSE_PASSWORD : Clickhouseのパスワード（デフォルト: ""）
CLICKHOUSE_DATABASE : 初期データベース（オプション）
CLICKHOUSE_READONLY : 読み取り専用モード（有効にするには 1/true に設定、デフォルト: false）

クイックスタート

インストール

クロードデスクトップ

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "clickhouse-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/burakdirin/Projects/clickhouse-mcp-server",
        "run",
        "clickhouse-mcp-server"
      ],
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_USER": "root",
        "CLICKHOUSE_PASSWORD": "password",
        "CLICKHOUSE_DATABASE": "[optional]",
        "CLICKHOUSE_READONLY": "true"
      }
    }
  }
}

{
  "mcpServers": {
    "clickhouse-mcp-server": {
      "command": "uvx",
      "args": [
        "clickhouse-mcp-server"
      ],
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_USER": "root",
        "CLICKHOUSE_PASSWORD": "password",
        "CLICKHOUSE_DATABASE": "[optional]",
        "CLICKHOUSE_READONLY": "true"
      }
    }
  }
}

Smithery経由でインストール

Smithery経由でClaude Desktop用のClickhouseデータベース統合サーバーを自動的にインストールするには：

npx -y @smithery/cli install @burakdirin/clickhouse-mcp-server --client claude

発達

建築と出版

配布用のパッケージを準備するには:

依存関係を同期し、ロックファイルを更新します。

uv sync

パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

PyPI に公開:

uv publish

注: 環境変数またはコマンドフラグを使用して PyPI 資格情報を設定する必要があります。

トークン: --tokenまたはUV_PUBLISH_TOKEN
またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/burakdirin/Projects/clickhouse-mcp-server run clickhouse-mcp-server

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

clickhouse-mcp-server

Integrations

Clickhouse MCPサーバー

インストール

コンポーネント

ツール

構成

クイックスタート

インストール

クロードデスクトップ

Smithery経由でインストール

発達

建築と出版

デバッグ

Related Resources