How to Configure Docker MCP Servers for OpenWebUI（2026-07-18）

如果你正在使用 OpenWebUI 搭建本地 AI 助手，是否曾为“模型无法访问外部工具”而烦恼？好消息是：通过配置 Docker 容器中的 MCP（Model Context Protocol）服务器，你可以让 AI 模型像拥有“手臂”一样调用代码解释器、文件系统、数据库甚至是第三方 API。

下面我会用最简单的方式，带你一步步完成配置，让 OpenWebUI 的 AI 真正“能干实事”。

什么是 Docker MCP 服务器？

简单理解，MCP 服务器是一个轻量级的中间层——它运行在 Docker 容器里，专门为 AI 模型提供可调用的“工具接口”。例如：

代码执行：让模型运行 Python 脚本
文件系统操作：读写本地文件（需权限控制）
API 调用：获取天气、搜索网页

根据 2025 年的一项社区调查，超过 60% 的高级用户在使用 OpenWebUI 时选择 MCP 方案来扩展 AI 能力，因为它是最安全且隔离性最好的方式（Docker 容器天然提供资源限制和网络隔离）。

前提条件

在开始前，请确保你已经安装并运行了：

Docker Engine（推荐 24.0+）
OpenWebUI（官方 Docker 镜像或本地安装均可）
一点耐心（毕竟第一次配置可能会踩小坑）

步骤 1：拉取 MCP 基础镜像

我们使用社区维护的 MCP 服务器镜像，它预装了 Python 3.12、Node.js 20 和常用工具库。

docker pull ghcr.io/open-webui/mcp-server:latest

这个镜像约 350MB，包含了运行大多数 MCP 工具所需的环境。如果拉取较慢，可以考虑配置镜像加速器。

步骤 2：启动 MCP 服务器容器

以最简单的“代码执行”工具为例，启动容器并映射端口：

docker run -d --name mcp-tools \
  -p 9090:9090 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/open-webui/mcp-server:latest

关键参数解释：

-p 9090:9090：将容器的 9090 端口暴露到主机，供 OpenWebUI 连接
-v /var/run/docker.sock：允许容器内执行 Docker 命令（需谨慎：这赋予了容器内代码管理宿主机 Docker 的能力）

如果你想限制权限，可以改为 -v /home/user/safe_dir:/workspace 仅挂载一个安全目录。

步骤 3：在 OpenWebUI 中添加 MCP 连接

进入 OpenWebUI 的管理界面：

点击右上角头像 → 管理面板
找到 MCP 服务器设置
点击 添加服务器
填写：
- 名称：MCP-Tools
- 地址：http://localhost:9090
- 协议：mcp
保存并测试连接（应该看到绿色“已连接”标志）

实际案例：一位开发者配置了 MCP 文件系统工具后，让 AI 模型每天自动整理下载文件夹——按扩展名分类、删除重复文件，全程无人工干预。

步骤 3.5：配置工具白名单（安全建议）

默认情况下，MCP 服务器会暴露所有内置工具。为了安全，建议你创建一个 tools.json 配置文件，只启用你需要的：

{
  "tools": ["execute_python", "read_file", "write_file"]
}

然后通过挂载该文件启动容器：

docker run -d --name mcp-tools \
  -p 9090:9090 \
  -v /path/to/tools.json:/app/tools.json \
  ghcr.io/open-webui/mcp-server:latest

常见问题与数据

根据运维经验，以下是最常见的“踩坑”点：

问题	解决
连接超时	检查 OpenWebUI 和 MCP 容器是否在同一个 Docker 网络；使用 `docker network create` 创建共享网络
权限错误	容器内以 `--user` 参数指定 UID，确保与主机挂载目录权限一致
工具调用无返回	在 MCP 容器中运行 `curl http://localhost:9090/health` 测试服务是否存活

实用建议：从简单开始

第一天：只配置代码执行工具，体验“让 AI 写 Python 脚本并返回结果”的快乐
第一周：增加文件读写工具，让 AI 帮你整理 CSV、生成报告
第一月：尝试自定义工具（如调用你的公司 API），但务必先在沙盒环境中测试

记住：工具越强大，风险控制越重要。永远不要挂载包含敏感数据的目录到容器。

写在最后

配置 Docker MCP 服务器一般只需要 15 分钟，但这 15 分钟能让你的 OpenWebUI 从“聊天机器人”升级为“自动化助手”。当你看到 AI 模型调用代码工具计算出结果，或者基于文件系统自动生成周报时，你会发现这一切都值得。

现在，就打开终端开始吧！如果卡在某个步骤，不妨搜索“MCP 服务器 debug”或查看官方 GitHub Issue 区——社区里的方案往往比想象中更直接。

行动号召：立即执行 docker run -d --name mcp-test -p 9090:9090 ghcr.io/open-webui/mcp-server:latest，然后在 OpenWebUI 中连接它，试试向 AI 提问：“执行 Python 代码计算 2026 年 7 月 18 日是星期几？”——它会给你一个惊喜。

免责声明：本文提供的配置方法基于开源社区的实践，Docker 容器执行代码可能带来安全风险。请确认你的环境满足最低安全要求（如防火墙、权限分离）。作者不对因配置不当导致的数据泄露或系统损坏承担责任。在生产环境使用前，请咨询专业安全人员。