🚀 ⚡️ mcpo 中文文档

mcpo 能够将任何 MCP 工具转换为兼容 OpenAPI 的 HTTP 服务器，让转换立即生效。它是一个简单易用的代理，可把 MCP 服务器命令转换为标准 RESTful OpenAPI 接口，让您的工具能“即插即用”地与 LLM 代理和应用程序（这些应用期望 OpenAPI 服务器）兼容，无需自定义协议、胶水代码，毫无麻烦。

🚀 快速开始

我们推荐使用 uv 以闪电般的速度启动并实现零配置。

uvx mcpo --port 8000 --api-key "top-secret" -- your_mcp_server_command

或者，如果您使用 Python：

pip install mcpo
mcpo --port 8000 --api-key "top-secret" -- your_mcp_server_command

如果需要使用支持 SSE（服务器发送事件）的 MCP 服务器，请指定服务器类型和端点：

mcpo --server-type sse --host your_sse_server_host:your_sse_server_port

使用配置文件管理多个工具：

mcpo --config your_config_file.yaml

启动后，访问http://localhost:8000查看自动生成的 API 文档。

✨ 主要特性

• 解决原生 MCP 问题：MCP 服务器通常使用原始 stdio 进行通信，存在固有不安全性、与大多数工具不兼容以及缺少标准功能（如文档、认证、错误处理等）的问题。mcpo 解决了所有这些问题，无需额外工作。
• 与 OpenAPI 兼容：立即与 OpenAPI 工具、SDK 和 UI 兼容。
• 增加安全性和稳定性：借助受信任的 Web 标准增加安全性和稳定性。
• 自动生成文档：自动生成交互式文档，无需任何配置。
• 使用纯 HTTP：使用纯 HTTP，无套接字、无胶水代码、无意外。

💻 使用示例

基础用法

1. 配置文件 your_config_file.yaml：

servers:
  - name: "tool1"
    host: "localhost:1234"
  - name: "tool2"
    host: "anotherhost:5678"

2. 启动后访问文档页面

高级用法

使用配置文件 config.yaml 管理工具：

servers:
  - name: "example_tool"
    host: "127.0.0.1:5000"

运行命令：

mcpo --config config.yaml

🔧 技术细节

技术要求

• Python：需要 Python 3.8 或更高版本。
• 依赖项：
  • uvicorn：用于启动 Web 服务器。
  • python-multipart：处理文件上传。

开发与测试

克隆仓库

git clone https://github.com/open-webui/mcpo.git
cd mcpo

安装依赖

pip install -r requirements.txt

启动测试

uvicorn main:app --reload

启动后，访问http://localhost:8000查看自动生成的文档。

🎯 目标

构建未来 AI 工具的互操作性！

✨ 让我们共同打造开放、互联的人工智能工具生态系统！