跳转到主要内容
本指南介绍如何配置 Open WebUI 与 ClickHouse MCP 服务器, 并将其连接到 ClickHouse 示例数据集。
1

安装 uv

按照本指南操作前,需要先安装 uv。 如果不想使用 uv,则需要更新 MCP 服务器的 config,改用其他 package manager。
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 API 端点
要在 Open WebUI 中使用这些端点,需要进入设置:
Open WebUI 设置
点击 Tools:
Open WebUI 工具
将 http://localhost:8000 添加为工具 URL:
Open WebUI 工具
完成后,聊天栏中的工具图标旁应该会显示一个 1:
Open WebUI 可用工具
点击工具图标后,即可查看可用工具列表:
Open WebUI 工具列表
4

配置 OpenAI

默认情况下,Open WebUI 使用 Ollama 模型,但也可以添加与 OpenAI 兼容的端点。 这些内容可通过设置菜单进行配置,这里需要点击 Connections 选项卡:
Open WebUI 连接
添加该端点以及 OpenAI 密钥:
Open WebUI - 添加 OpenAI 作为连接
随后,OpenAI 模型就会出现在顶部菜单中:
Open WebUI - 模型
5

通过 Open WebUI 与 ClickHouse MCP 服务器聊天

接下来即可开始对话,Open WebUI 会在需要时调用 MCP 服务器:
Open WebUI - 与 ClickHouse MCP 服务器聊天