> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 在 Open WebUI 中使用 ClickHouse MCP 服务器
> 本指南介绍如何使用 Docker 为 Open WebUI 设置 ClickHouse MCP 服务器。
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> 本指南介绍如何为 [Open WebUI](https://github.com/open-webui/open-webui) 配置 ClickHouse MCP 服务器，
> 并将其连接到 ClickHouse 示例数据集。
## 安装 uv
要按照本指南操作，你需要先安装 [uv](https://docs.astral.sh/uv/)。
如果你不想使用 uv，则需要更新 MCP 服务器配置，改用其他包管理器。
## 启动 Open WebUI
要启动 Open WebUI，可以运行以下命令：
```bash theme={null}
uv run --with open-webui open-webui serve
```
访问 [http://localhost:8080/](http://localhost:8080/) 即可打开 UI。
## 配置 ClickHouse MCP 服务器
要设置 ClickHouse MCP 服务器，我们需要先将 MCP 服务器转换为 Open API 端点。
首先，设置环境变量，以便连接到 ClickHouse SQL Playground：
```bash theme={null}
export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""
```
然后，运行 `mcpo` 来创建 Open API 端点：
```bash theme={null}
uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
```
访问 [http://localhost:8000/docs](http://localhost:8000/docs) 即可查看已创建的端点列表。
要在 Open WebUI 中使用这些端点，需要进入设置：
点击 `Tools`：
将 [http://localhost:8000](http://localhost:8000) 添加为工具 URL：
完成后，你应该会在聊天栏的工具图标旁看到一个 `1`：
点击工具图标后，就可以查看可用工具列表：
## 配置 OpenAI
默认情况下，Open WebUI 使用 Ollama 模型，但也可以添加与 OpenAI 兼容的端点。
这些连接可通过设置菜单进行配置，不过这次需要点击 `Connections` 选项卡：
添加端点和你的 OpenAI 密钥：
之后，OpenAI 模型就会显示在顶部菜单中：
## 在 Open WebUI 中与 ClickHouse MCP 服务器对话
然后，你就可以开始对话；如有需要，Open WebUI 会调用 MCP 服务器：