在 Open WebUI 中使用 ClickHouse MCP 服务器

按照本指南操作前，需要先安装 uv。 如果不想使用 uv，则需要更新 MCP 服务器的 config，改用其他 package manager。

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

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

访问 http://localhost:8080/ 即可打开 UI。

要配置 ClickHouse MCP 服务器，需要先将 MCP 服务器转换为 Open API 端点。 首先，设置环境变量，以便连接到 ClickHouse SQL playground：

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

然后，运行 mcpo 来创建 Open API 端点：

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 服务器：