在 Open WebUI 中使用 ClickHouse MCP 服务器

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

安装 uv

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

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

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

要配置 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 的端点。这些可以在设置菜单中进行配置，这次我们需要点击 Connections 选项卡：

接下来添加该端点以及我们的 OpenAI 密钥：

随后，OpenAI 模型会出现在顶部菜单中：

然后我们可以进行对话,Open WebUI 会在必要时调用 MCP 服务器: