> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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](https://docs.astral.sh/uv/)。
如果不想使用 uv，则需要更新 MCP 服务器的 config，改用其他 package manager。
要启动 Open WebUI，可以运行以下命令：
```bash theme={null}
uv run --with open-webui open-webui serve
```
访问 [http://localhost:8080/](http://localhost:8080/) 即可打开 UI。
要配置 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`：
点击工具图标后，即可查看可用工具列表：
默认情况下，Open WebUI 使用 Ollama 模型，但也可以添加与 OpenAI 兼容的端点。
这些内容可通过设置菜单进行配置，这里需要点击 `Connections` 选项卡：
添加该端点以及 OpenAI 密钥：
随后，OpenAI 模型就会出现在顶部菜单中：
接下来即可开始对话，Open WebUI 会在需要时调用 MCP 服务器：