Claude DesktopでClickHouse MCPサーバーを使う

このガイドでは、uv を使って Claude Desktop を ClickHouse MCPサーバーに設定し、 ClickHouse のサンプルデータセットに接続する方法を説明します。

uvをインストールする

このガイドの手順に従うには、uv をインストールする必要があります。 uv を使わない場合は、別のパッケージマネージャーを使うように MCPサーバーの設定を更新する必要があります。

Claude Desktopをダウンロードする

Claude Desktop アプリもインストールする必要があります。これは Claude Desktop website からダウンロードできます。

ClickHouse MCPサーバーを設定する

Claude Desktop をインストールしたら、次は ClickHouse MCPサーバーを設定します。これは Claude Desktop configuration file で行えます。このファイルを見つけるには、まず設定ページ (Mac では Cmd+,) を開き、左側のメニューで Developer タブをクリックします。すると次の画面が表示されるので、Edit config ボタンをクリックします。すると、設定ファイル (claude_desktop_config.json) があるディレクトリが開きます。このファイルを初めて開いたときは、おそらく次の内容になっています。

{
  "mcpServers": {}
}

mcpServers Dictionary は、キーとして MCPサーバー名を取り、値として設定オプションの Dictionary を取ります。たとえば、ClickHouse Playground に接続する ClickHouse MCPサーバーの設定は次のようになります。

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": "",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

設定を更新したら、変更を反映するために Claude Desktop を再起動する必要があります。

uv のインストール方法によっては、Claude Desktop の再起動時に次のエラーが表示されることがあります。

MCP mcp-clickhouse: spawn uv ENOENT

その場合は、command を uv のフルパスに更新する必要があります。たとえば Cargo 経由でインストールした場合は /Users/<username>/.cargo/bin/uv になります。

ClickHouse MCPサーバーを使う

Claude Desktop を再起動したら、Search and tools アイコンをクリックして ClickHouse MCPサーバーを見つけられます。
その後、すべてのツールを無効にするか、一部だけ無効にするかを選べます。これで、ClickHouse MCPサーバーを使って Claude に質問する準備が整いました。たとえば、What's the most interesting dataset in the SQL playground? と尋ねることができます。Claude は、MCPサーバー内の各ツールを初めて呼び出す際に、その使用を確認するよう求めます。以下では、ClickHouse MCPサーバーへのいくつかのツール呼び出しを含む会話の一部を確認できます。

最終更新日 2026年7月23日

LibreChatを統合このガイドでは、Dockerを使用してClickHouse MCPサーバーと連携するLibreChatをセットアップする方法を説明します。