使用 ClickHouse MCP 服务器与 Open WebUI

本指南解释了如何设置 Open WebUI 与 ClickHouse MCP 服务器，并将其连接到 ClickHouse 示例数据集。

安装 uv

您需要安装 uv 来按照本指南中的说明进行操作。如果您不想使用 uv，则需要更新 MCP Server 配置以使用替代的包管理器。

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