在 Claude Desktop 中使用 ClickHouse MCP 服务器

本指南介绍如何使用 uv 为 Claude Desktop 设置 ClickHouse MCP 服务器, 并将其连接到 ClickHouse 示例数据集。

安装 uv

你需要先安装 uv，才能按照本指南中的步骤进行操作。 如果你不打算使用 uv，则需要更新 MCP Server 配置以改用其他包管理器。

下载 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 Server 的名称作为键，以配置选项的字典作为值。
例如，连接到 ClickHouse Playground 的 ClickHouse MCP Server 配置如下：

{
  "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 服务器:

然后您可以选择禁用全部或部分工具。

现在我们可以向 Claude 提问,这将触发它使用 ClickHouse MCP 服务器。 例如,我们可以询问 What's the most interesting dataset in the SQL playground?。

Claude 会在首次调用时要求我们确认使用 MCP 服务器中的每个工具:

下面您可以看到包含对 ClickHouse MCP 服务器的一些工具调用的对话片段: