Skip to main content
本指南介绍如何为 Open WebUI 配置 ClickHouse MCP 服务器, 并将其连接到 ClickHouse 示例数据集。
1

安装 uv

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

启动 Open WebUI

要启动 Open WebUI,可以运行以下命令:
访问 http://localhost:8080/ 即可打开 UI。
3

配置 ClickHouse MCP 服务器

要设置 ClickHouse MCP 服务器,我们需要先将 MCP 服务器转换为 Open API 端点。 首先,设置环境变量,以便连接到 ClickHouse SQL Playground:
然后,运行 mcpo 来创建 Open API 端点:
访问 http://localhost:8000/docs 即可查看已创建的端点列表。要在 Open WebUI 中使用这些端点,需要进入设置:点击 Toolshttp://localhost:8000 添加为工具 URL:完成后,你应该会在聊天栏的工具图标旁看到一个 1点击工具图标后,就可以查看可用工具列表:
4

配置 OpenAI

默认情况下,Open WebUI 使用 Ollama 模型,但也可以添加与 OpenAI 兼容的端点。 这些连接可通过设置菜单进行配置,不过这次需要点击 Connections 选项卡:添加端点和你的 OpenAI 密钥:之后,OpenAI 模型就会显示在顶部菜单中:
5

在 Open WebUI 中与 ClickHouse MCP 服务器对话

然后,你就可以开始对话;如有需要,Open WebUI 会调用 MCP 服务器:
最后修改于 2026年7月3日