OpenWebUI 集成的 OpenAPI 生成

MCPHub 现在支持从 MCP 工具生成 OpenAPI 3.0.3 规范，实现与 OpenWebUI 和其他 OpenAPI 兼容系统的无缝集成，无需 MCPO 作为中间代理。

功能特性

✅ 自动 OpenAPI 生成：将 MCP 工具转换为 OpenAPI 3.0.3 规范
✅ OpenWebUI 兼容：无需 MCPO 代理的直接集成
✅ 实时工具发现：动态包含已连接 MCP 服务器的工具
✅ 双参数支持：支持 GET（查询参数）和 POST（JSON 正文）进行工具执行
✅ 无需身份验证：OpenAPI 端点公开，便于集成
✅ 完整元数据：具有适当模式和文档的完整 OpenAPI 规范

API 端点

OpenAPI 规范

curl "http://localhost:3000/api/openapi.json"

curl "http://localhost:3000/api/openapi.yaml"

curl "http://localhost:3000/api/openapi.json?title=我的 MCP API&version=2.0.0"

生成并返回所有已连接 MCP 工具的完整 OpenAPI 3.0.3 规范。.json 和 .yaml 版本接受相同的查询参数。 查询参数：

string

自定义 API 标题

string

自定义 API 描述

string

自定义 API 版本

string

自定义服务器 URL

boolean

default:"false"

包含禁用的工具

string

要包含的服务器名称列表（逗号分隔）

组/服务器特定的 OpenAPI 规范

curl "http://localhost:3000/api/mygroup/openapi.json"

curl "http://localhost:3000/api/mygroup/openapi.yaml"

curl "http://localhost:3000/api/myserver/openapi.json?title=我的服务器 API&version=1.0.0"

为特定组或服务器生成并返回 JSON 或 YAML 格式的 OpenAPI 3.0.3 规范。如果存在具有给定名称的组，则返回该组中所有服务器的规范。否则，将名称视为服务器名称并仅返回该服务器的规范。 路径参数：

string

required

组 ID/名称或服务器名称

查询参数： 与主 OpenAPI 规范端点相同（title、description、version、serverUrl、includeDisabled）。

可用服务器

curl "http://localhost:3000/api/openapi/servers"

返回已连接的 MCP 服务器名称列表。

{
  "success": true,
  "data": ["amap", "playwright", "slack"]
}

工具统计

curl "http://localhost:3000/api/openapi/stats"

返回有关可用工具和服务器的统计信息。

{
  "success": true,
  "data": {
    "totalServers": 3,
    "totalTools": 41,
    "serverBreakdown": [
      {"name": "amap", "toolCount": 12, "status": "connected"},
      {"name": "playwright", "toolCount": 21, "status": "connected"},
      {"name": "slack", "toolCount": 8, "status": "connected"}
    ]
  }
}

工具执行

curl "http://localhost:3000/api/tools/amap/amap-maps_weather?city=Beijing"

curl -X POST "http://localhost:3000/api/tools/playwright/playwright-browser_navigate" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

通过 OpenAPI 兼容端点执行 MCP 工具。 路径参数：

string

required

MCP 服务器的名称

string

required

要执行的工具名称