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

Open WebUI MCPo 技术解析:将 MCP 工具转换为 OpenAPI 接口

MCPo 是将 Model Context Protocol 工具转换为兼容 OpenAPI 的 HTTP 服务器的代理方案。它通过标准化 RESTful 接口,实现 MCP 工具与大语言模型及应用程序的无缝交互。核心功能包括即时兼容性、安全性认证(JWT/API Key)、自动生成 Swagger 文档及纯 HTTP 支持。MCPo 支持图像内容处理、CLI API 密钥认证及灵活跨域控制。文章介绍了 MCPo 的工作原理、安装步骤(Ollama、Open WebUI、MCPo)及通过 Python 调用 MCP Fetch Server 的测试方法,为开发者提供高效安全的 AI 工具集成桥梁。

草莓泡芙发布于 2026/2/6更新于 2026/10/24103 浏览
Open WebUI MCPo 技术解析:将 MCP 工具转换为 OpenAPI 接口

Open WebUI MCPo 项目介绍

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

什么是 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

此外,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

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

更多推荐文章

查看全部
  • 昇腾 NPU 实战指南:部署与推理 CodeLlama
  • MCP 模型上下文协议:原理、架构与应用场景解析
  • OpenClaw 框架解析:AI Agent、RAG、MCP 与 Skills 核心概念梳理
  • Django REST Framework 企业级 API 架构实战
  • Spring Web MVC 核心概念与实战指南
  • 树莓派 Python 音频播放开发实战指南
  • Visual C++ 运行库缺失问题排查与修复指南
  • 二分答案专题实战:木材加工与砍树问题详解
  • C++ string 使用详解与底层模拟实现
  • Mac mini M4 部署 OpenClaw + Ollama 本地大模型接入飞书机器人
  • 大模型转行指南:四大方向解析与入行建议
  • C++ 二叉搜索树原理与实现
  • Ubuntu 24.04 更换阿里云镜像源指南
  • PostgreSQL 18 默认密码修改与安全加固指南
  • 鸿蒙金融理财全栈项目:风险控制、合规审计与产品创新
  • C++11 右值引用与移动语义详解:从性能瓶颈到零拷贝优化
  • 鸿蒙金融理财全栈项目:运维监控、性能优化与安全加固
  • Clang Power Tools:在 Visual Studio 里做 C++ 静态分析
  • 大模型基本概念详解:定义、发展、特点与分类
  • RAG 实战:利用 Langchain 和 Milvus 构建本地知识库

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如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