使用 ClickHouse MCP 服务器与 Open WebUI

本指南介绍如何将 Open WebUI 与 ClickHouse MCP 服务器配置在一起，并将其连接到 ClickHouse 示例数据集。

安装 uv

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

要启动 Open WebUI，你可以运行以下命令：

uv run --with open-webui open-webui serve

访问 http://localhost:8080/ 以查看 UI。

要配置 ClickHouse MCP Server，我们需要将 MCP Server 暴露为一组 OpenAPI 端点。首先，先设置环境变量，以便连接到 ClickHouse SQL Playground：

export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""

然后我们可以运行 mcpo 来创建 OpenAPI 端点：

uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse

你可以通过访问 http://localhost:8000/docs 查看已创建的端点列表。

要在 Open WebUI 中使用这些端点，我们需要先进入设置：

点击 Tools：

将 http://localhost:8000 添加为工具的 URL：

完成上述操作后，你应该会在聊天栏的工具图标旁看到一个数字 1：

点击工具图标后，就可以看到可用工具列表：

默认情况下，Open WebUI 使用 Ollama 模型，但我们也可以添加与 OpenAI 兼容的端点。这些内容通过设置菜单进行配置，不过这次需要点击 创建 选项卡：

接下来添加端点和你的 OpenAI 密钥：

随后，OpenAI 模型将在顶部菜单中可用：

然后，你就可以开始对话，Open WebUI 会在需要时调用 MCP 服务器：