clickhouse-mcp-server

Clickhouse MCPサーバー

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

インストール

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

またはpipを使用します:

コンポーネント

ツール

サーバーは次の 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

Smithery経由でインストール

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

発達

建築と出版

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

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

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

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

3. PyPI に公開:

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

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

デバッグ

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

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

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