mcpo

🚀 ⚡️ mcpo中文文档

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

🚀 快速开始

我们推荐使用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工具转换为兼容OpenAPI的HTTP服务器，使工具可“即插即用”地与LLM代理和应用程序兼容。
• 解决了原生MCP服务器使用原始stdio通信存在的问题，如固有不安全性、与大多数工具不兼容、缺少标准功能（文档、认证、错误处理等）。
• 立即与OpenAPI工具、SDK和UI兼容。
• 借助受信任的Web标准增加安全性和稳定性。
• 自动生成交互式文档，无需任何配置。
• 使用纯HTTP，无套接字、无胶水代码、无意外。

🤔 为什么选择mcpo而不是原生MCP？

MCP服务器通常使用原始stdio进行通信，存在以下弊端：

• 不安全：固有不安全性。
• 不兼容：与大多数工具不兼容。
• 缺少标准功能：如文档、认证、错误处理等。

mcpo解决了所有这些问题，且无需额外工作：

• ✅ 立即与OpenAPI工具、SDK和UI兼容。
• 🛡 借助受信任的Web标准增加安全性和稳定性。
• 🧠 自动生成交互式文档，无需任何配置。
• 🔌 使用纯HTTP——无套接字、无胶水代码、无意外。

看似“多一步骤”，实际上带来了更少的步骤和更好的结果。mcpo使您的AI工具变得可用、安全且互操作性更强，立即生效，零麻烦。

💻 使用示例

基础用法

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工具的互操作性！

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