Mcpo

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

✨ 讓我們共同打造開放、互聯的人工智能工具生態系統！