在 Claude Desktop 中使用 ClickHouse MCP 服务器

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

安装 uv

要按照本指南进行操作，你需要先安装 uv。如果你不想使用 uv，则需要更新 MCP 服务器配置，改用其他包管理器。

下载 Claude Desktop

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

配置 ClickHouse MCP 服务器

安装好 Claude Desktop 后，就可以开始配置 ClickHouse MCP 服务器了。这可以通过 Claude Desktop 配置文件完成。要找到该文件，请先进入设置页面 (Cmd+, 在 Mac 上)，然后点击左侧菜单中的 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

使用 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 服务器的工具调用：

最后修改于 2026年7月23日

集成 LibreChat本指南介绍如何使用 Docker 为 LibreChat 配置 ClickHouse MCP 服务器。