masterno12/webui-mcpo

🧠 webui-mcpo：通过单一配置在Open WebUI上运行多个MCP工具

该Docker镜像提供了一个轻量级环境，用于运行https://github.com/open-webui/mcpo%E2%80%94%E2%80%94%E4%B8%80%E4%B8%AA%E9%80%82%E7%94%A8%E4%BA%8EOpen WebUI的多功能MCP服务器启动器。

🚀 什么是MCPO？

MCPO是一个服务器，它通过单个配置文件编排多个MCP工具，为每个工具提供统一的HTTP接口。

官方MCP工具可在此获取：
👉 https://github.com/modelcontextprotocol/servers

本项目专注于使用Claude桌面格式，通过统一接口在一个配置下运行多个MCP工具。

💡 为什么采用这种方式？

刚开始使用时，我发现Open WebUI官方文档通常强调单行启动命令（例如直接使用npx或uvx），并提供从Claude配置到单行命令的转换方法。

然而，我注意到两点：

• MCP服务器注册表（https://github.com/modelcontextprotocol/servers%EF%BC%89%E5%87%A0%E4%B9%8E%E6%80%BB%E6%98%AF%E6%8F%90%E4%BE%9B**Claude%E9%A3%8E%E6%A0%BC%E7%9A%84JSON%E9%85%8D%E7%BD%AE**%EF%BC%8C%E8%80%8C%E9%9D%9E%E5%8D%95%E8%A1%8C%E5%91%BD%E4%BB%A4%E3%80%82
• MCPO作为中心枢纽时，直接期望Claude配置——手动将它们转换为单行命令没有任何好处。

因此，与其手动将JSON块转换为CLI命令，不如完全采用Claude配置格式。这使得设置更清晰、更易于维护，并且与mcpo完美兼容。

🐳 快速开始

1. 拉取镜像

bash
docker pull masterno12/webui-mcpo:latest

2. 创建配置文件

你必须在本地文件夹（例如mcpo/）中提供config.json。如果mcpo/config.json不存在，容器将自动生成一个最小化的默认配置。本地文件夹mcpo/必须与docker-compose.yml在同一目录下。

📄 示例config.json：

json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=America/New_York"]
    }
  }
}

3. 手动启动容器

bash
docker run -d \
  --name webui-mcpo \
  -p 8000:8000 \
  -v $(pwd)/mcpo:/opt/mcpo \
  -e MCPO_API_KEY=top-secret \  # 可选：定义API密钥
  masterno12/webui-mcpo:latest

🧬 Docker Compose示例

yaml
services:
  mcpo:
    image: masterno12/webui-mcpo:latest
    container_name: webui-mcpo
    ports:
      - "8000:8000"
    volumes:
      - ./mcpo:/opt/mcpo
# 可选：定义API密钥
#    environment:
#      - MCPO_API_KEY=top-secret
    restart: unless-stopped

启动命令：

bash
docker compose up -d

🌐 访问MCP工具

运行后，每个MCP服务器通过独立的HTTP路由暴露：

• http://localhost:8000/memory
• http://localhost:8000/time

每个路由都配有独立的OpenAPI UI：

• http://localhost:8000/memory/docs
• http://localhost:8000/time/docs

🧩 更多关于MCP

• 📖 什么是MCP？
• 🧰 https://github.com/modelcontextprotocol/servers
• 🧠 https://github.com/open-webui/mcpo

🧾 GitHub源码

👉 https://github.com/masterno12/webui-mcpo

📦 更新日志

v1.2 – 通过环境变量添加API密钥支持（2025-05-24）

• ✅ 支持通过MCPO_API_KEY环境变量注入API密钥。
• 🛠️ 更新entrypoint.sh，若存在该变量则动态追加--api-key参数。
• 📁 仍使用config.json进行服务器配置。
• 📄 改进Docker Compose使用文档。
• 🧪 与v1.1配置文件向后兼容。

v1.1 – 初始版本

• 🧠 基础mcpo Docker镜像，支持配置文件。
• 🚀 轻量级且即用型的Open WebUI MCP服务器启动器。