在 Open WebUI 中使用 ClickHouse MCP 服务器

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

安装 uv

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

启动 Open WebUI

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

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

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

配置 ClickHouse MCP 服务器

要配置 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：点击工具图标后，即可查看可用工具列表：

配置 OpenAI

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

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

接下来即可开始对话，Open WebUI 会在需要时调用 MCP 服务器：

最后修改于 2026年7月23日

集成 Ollama本指南介绍如何为 Ollama 配置 ClickHouse MCP 服务器。