使用 ClickHouse MCP 服务器与 Claude Desktop

本指南解释了如何使用 uv 设置 Claude Desktop 与 ClickHouse MCP 服务器并连接到 ClickHouse 示例数据集。

安装 uv

您需要安装 uv 才能按照本指南中的说明进行操作。如果您不想使用 uv，则需要更新 MCP 服务器配置以使用其他软件包管理器。

下载 Claude Desktop

您还需要安装 Claude Desktop 应用程序，可以从 Claude Desktop 网站下载。

配置 ClickHouse MCP 服务器

安装好 Claude Desktop 后，接下来是配置 ClickHouse MCP 服务器。我们可以通过 Claude Desktop 配置文件来实现这一点。

要找到此文件，首先转到设置页面（在 Mac 上按 Cmd+,），然后单击左侧菜单中的 Developer 选项卡。您将看到以下屏幕，您需要单击 Edit config 按钮：

这将带您进入包含配置文件 (claude_desktop_config.json) 的目录。第一次打开该文件时，它可能包含以下内容：

{
  "mcpServers": {}
}

mcpServers 字典以 MCP 服务器的名称作为键，以配置选项的字典作为值。
例如，连接到 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