跳到主要内容
跳到主要内容

使用 ClickHouse MCP 服务器与 Open WebUI

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

安装 uv

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

启动 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 API endpoints

要在 Open WebUI 中使用这些端点,我们需要导航到设置:

Open WebUI settings

点击 Tools

Open WebUI tools

添加 http://localhost:8000 作为工具 URL:

Open WebUI tool

完成此操作后,我们应该在聊天栏的工具图标旁边看到 1

Open WebUI tools available

如果我们点击工具图标,就可以列出可用的工具:

Open WebUI tool listing

配置 OpenAI

默认情况下,Open WebUI 与 Ollama 模型一起工作,但我们也可以添加与 OpenAI 兼容的端点。这些通过设置菜单进行配置,但这次我们需要点击 Connections 选项卡:

Open WebUI connections

让我们添加端点和我们的 OpenAI 密钥:

Open WebUI - Add OpenAI as a connection

然后,OpenAI 模型将在顶部菜单中可用:

Open WebUI - Models

与 ClickHouse MCP 服务器进行聊天

然后,我们可以进行对话,Open WebUI 在必要时将调用 MCP 服务器:

Open WebUI - Chat with ClickHouse MCP Server