mcpo

MCPO：打破协议壁垒，让 LLM 真正“触达”本地工具

在 AI 应用生态中，MCP (Model Context Protocol) 正在成为连接大模型与外部数据的标准协议。然而，许多现有的 MCP 服务基于本地标准输入输出（stdio），难以直接被 Web 端的 AI UI 调用。

MCPO (MCP via Proxy) 是由 Open WebUI 官方推出的核心扩展项目。它作为一个高性能、安全的代理网关，能将基于 stdio 的本地 MCP 服务器“变身”为标准的 OpenAPI (RESTful) 接口，从而让 Open WebUI 等 Web 应用能够无缝调用本地工具。

网站截图

核心功能：连接、安全与自动化

1. 协议转换与桥接

• Stdio 转 OpenAPI： 它是目前最简洁的方案，能将原本只能在本地命令行运行的 MCP 工具（如 Claude Desktop 的各类插件）映射为 Web 可访问的 API 端点。

• 多源支持： 不仅支持本地 stdio，还适配了 SSE (Server-Sent Events) 和可流式传输的 HTTP MCP 服务器。

2. 极简的自动化集成

• 自动 Schema 生成： MCPO 会自动解析 MCP 服务器的功能，并动态生成对应的 OpenAPI 规范（JSON/YAML），Open WebUI 只需接入该 URL 即可获得所有工具。

• 一键式部署： 支持 uvx 快速启动或 Docker 容器化部署，几秒钟内即可建立稳定的代理通道。

3. 企业级安全增强

• 鉴权保护： 支持 API Key 验证及 OAuth 2.1 动态客户端注册，确保只有授权请求能调用你的本地 MCP 资源。

• 沙箱化思维： 通过代理层隔离，有效避免了 Web 端直接对本地系统进行非受控访问的风险。

4. 高级调度与监控

• Header 透传： 支持将客户端 HTTP Header（如 Trace ID、关联 ID）转发至后端，方便分布式环境下的链路追踪。

• 动态控制： 运行时可调整日志级别，并支持 disabled_tools 配置，无需重启即可禁用特定敏感工具。

典型应用场景

快速上手（以 uvx 为例）

只需一行命令，即可将本地的时间插件转化为 API 服务：

uvx mcpo --port 8000 --api-key "your-secret-key" -- uvx mcp-server-time

启动后，在 Open WebUI 的 Admin Panel > External Tools 中添加 http://localhost:8000/docs 即可完成对接。

总结： MCPO 是 Open WebUI 生态中不可或缺的“翻译官”。它通过标准化的手段，让 LLM 能够安全地走出浏览器，成为真正能操作本地电脑、查询真实数据的强大助手。