跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI算法

Open WebUI MCPo 项目详解:将 MCP 工具转换为 OpenAPI 服务

MCPo 是将 Model Context Protocol 工具转换为兼容 OpenAPI 的 HTTP 服务器的代理方案。它通过标准化 RESTful API 接口,实现 MCP 工具与大语言模型及应用程序的无缝交互。核心功能包括即时兼容性、HTTPS 安全传输、JWT 认证及自动生成 Swagger UI 文档。支持图像内容处理、CLI API 密钥认证及灵活的跨域访问控制。 MCPo 的工作原理、安装步骤及在 Open WebUI 中的集成方法,提供了 Python 调用示例,帮助开发者快速构建安全的 AI 工具接口。

古灵精怪发布于 2026/2/6更新于 2026/10/228.1K 浏览
Open WebUI MCPo 项目详解:将 MCP 工具转换为 OpenAPI 服务

Open WebUI 的 MCPo 项目:将 MCP 工具无缝集成到 OpenAPI 的创新解决方案

随着人工智能工具和模型的快速发展,如何高效、安全地将这些工具集成到标准化的 API 接口中成为了开发者面临的重要挑战。Open WebUI 的 MCPo 项目(Model Context Protocol-to-OpenAPI Proxy Server)正是为了解决这一问题而设计的。本文将带您深入了解 MCPo 的功能、优势及其对开发者生态的影响。


什么是 MCPo?

MCPo 是一个简单、可靠的代理服务器,能够将任何基于 MCP 协议的工具转换为兼容 OpenAPI 的 HTTP 服务器。它通过标准化 RESTful API 接口,让复杂的工具变得易于使用,并支持与大语言模型(LLM)代理和应用程序的无缝交互。

核心功能:
  • 即时兼容性:支持 OpenAPI 工具、SDK 和用户界面,无需额外配置。
  • 安全性与稳定性:采用标准化的 HTTPS 传输协议,支持 JWT 和 API 密钥认证。
  • 自动生成文档:无需手动配置,自动生成交互式 Swagger UI 文档。
  • 纯 HTTP 支持:无需额外的套接字或胶合代码,简化开发流程。

MCPo 的工作原理

MCPo 的核心在于其代理功能,它能够动态发现 MCP 工具并生成 REST API 端点,同时提供人性化的 OpenAPI 文档。以下是其典型工作流程:

  1. 自动生成 API 文档,访问地址为 http://localhost:8000/docs。
  2. 用户可以直接调用生成的 API 端点,通过 HTTP 客户端或其他工具进行交互。

启动 MCPo 服务器,例如:

uvx mcpo --port 8000 -- your_mcp_server_command

或使用 Python 环境:

pip install mcpo
mcpo --port 8000 -- your_mcp_server_command

此外,MCPo 支持通过配置文件管理多个 MCP 工具,使不同工具可以通过唯一路由访问。例如:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "time": {
       
        
    
  

"command"
:
"uvx"
,
"args"
:
[
"mcp-server-time"
,
"--local-timezone=America/New_York"
]
}
}
}

最新功能更新

根据项目最新发布的更新日志,MCPo 引入了以下新特性:

  • 图像内容支持:现在可以直接处理 MCP 工具生成的图像内容,并以二进制格式返回给用户,用于动态图表、AI 艺术等场景。
  • CLI API 密钥认证:通过 -api-key 参数轻松保护端点,适用于公共或多代理部署。
  • 灵活的跨域访问控制(CORS):新增 -cors-allow-origins 参数,为前端应用和远程 UI 集成提供支持,同时保持安全性。

为什么选择 MCPo?

相比原生 MCP 协议,MCPo 提供了显著优势:

  • 用户友好的接口:不需要学习新的协议,仅需熟悉 HTTP REST 接口即可操作。
  • 即插即用的集成能力:兼容数千种现有工具和服务。
  • 强大的文档支持:自动维护准确且易用的文档。
  • 安全与稳定性保障:基于成熟框架(如 FastAPI),确保高性能和长久支持。

社区反馈与未来发展

MCPo 项目已在 GitHub 和 Reddit 社区中引发广泛讨论。开发者对其易用性和强大的功能表示认可,同时也提出了改进建议,例如增加 SSL 支持和更灵活的配置选项。

随着人工智能工具需求的增长,MCPo 有望成为连接 AI 工具与标准化接口的重要桥梁,为开发者提供更高效、更安全的解决方案。


安装 Ollama

Ollama

在 Ollama 中安装模型
ollama run gemma3
安装 MCPo
# 安装 mcpo
pip install mcpo

# 启动时间 mcp server
uvx mcpo --port 8000 --api-key "top-secret" -- uvx mcp-server-time --local-timezone=America/New_York

# 启动 fetch mcp server
uvx mcpo --port 8000 -- uvx mcp-server-fetch

# 查看文档
http://localhost:8000/docs
http://localhost:8000/openapi.json

# 使用配置文件启动
mcpo --config /path/to/config.json

# 配置文件示例
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "time": {
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=America/New_York"]
    }
  }
}
安装 Open WebUI
# pip 安装
pip install -U open-webui
open-webui serve

# 源代码安装
git clone -b v0.6.0 https://github.com/open-webui/open-webui.git
cd open-webui/
cp -RPp .env.example .env
npm i
npm run build
cd ./backend
pip install -r requirements.txt -U

# 启动
bash start.sh
测试通过 MCPO 调用 MCP Fetch server
import requests
import json

def fetch_webpage(url, max_length=10000, start_index=0, raw=False):
    """
    Fetch content from a URL using the MCP Fetch server.
    Args:
        url (str): The URL to fetch
        max_length (int): Maximum number of characters to return
        start_index (int): Start content from this character index
        raw (bool): Get raw HTML content without markdown conversion
    Returns:
        dict: The response from the server containing the fetched content
    """
    try:
        # Make a POST request to the fetch endpoint
        response = requests.post(
            "http://localhost:8000/fetch",
            json={
                "url": url,
                "max_length": max_length,
                "start_index": start_index,
                "raw": raw
            }
        )
        # Ensure the request was successful
        response.raise_for_status()
        # Parse the response
        return response.json()
    except Exception as e:
        return {"error": str(e)}

# Example usage
if __name__ == "__main__":
    # Fetch the specific URL you requested
    target_url = "https://www.aivi.fyi/aiagents/RooCode-Gemini2.5Pro-OpenAIAgentsSDK"
    result = fetch_webpage(target_url)
    print(result)

目录

  1. 什么是 MCPo?
  2. 核心功能:
  3. MCPo 的工作原理
  4. 最新功能更新
  5. 为什么选择 MCPo?
  6. 社区反馈与未来发展
  7. 安装 Ollama
  8. 在 Ollama 中安装模型
  9. 安装 MCPo
  10. 安装 mcpo
  11. 启动时间 mcp server
  12. 启动 fetch mcp server
  13. 查看文档
  14. 使用配置文件启动
  15. 配置文件示例
  16. 安装 Open WebUI
  17. pip 安装
  18. 源代码安装
  19. 启动
  20. 测试通过 MCPO 调用 MCP Fetch server
  21. Example usage

更多推荐文章

查看全部
  • Arduino BLDC 无刷电机模糊逻辑避障控制实战
  • Dify MCP-Server 插件:将工作流发布为第三方可调用服务
  • 突破 LLM 上下文瓶颈:上下文内存虚拟化 CMV 的设计与实践
  • MySQL 安装指南:Ubuntu 环境下快速部署与配置
  • AI 数据标注平台选型实践与效率提升技术逻辑
  • 基于 Django 的 4S 店客户管理系统设计与实现
  • Android 性能优化实战指南:核心原理与面试应对策略
  • 英文论文 AI 率检测:IThenticate 与 Turnitin 系统对比
  • 二分答案专题实战:木材加工与砍树问题解析
  • Python Selenium 模拟登录实战与自动化技巧
  • Llama-Factory 大模型微调实战指南
  • GitHub Copilot 学生开发者包申请与激活指南
  • 企业级 Web 大学生一体化服务平台管理系统:SpringBoot+Vue+MyBatis 架构
  • LangChain4j 集成多模型 Provider 方案:OpenAI 与本地模型混合部署
  • 算法题解:740.删除并获得点数
  • 无人机避障:Mid360+Fast-lio 感知建图+Ego-planner 运动规划
  • 快速排序:划分方法、优化与非递归实现
  • 大模型训练原理:从自监督学习到 GPT 架构解析
  • whisper.cpp 离线语音识别快速上手指南
  • B站:从二次元社区到AI创新孵化器的转型

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online