Agent Skill 核验档案

Openapi To MCP

openapi-to-mcp 是一个基于 mcp-use TypeScript SDK 的技能，用于把 OpenAPI 3.x 或 Swagger 2.0 规范文档转换为 MCP 服务器：规范中的每个操作变成一个 LLM 可调用的 MCP 工具，服务器本地运行测试后可部署到 Manufact / mcp-use cloud。

适用任务

把用户提供的 openapi.yaml / openapi.json / swagger.json 转换为可被 Claude/ChatGPT 调用的 MCP 工具服务器
将 Swagger 2.0 规范经 swagger2openapi 转换后解引用，并把每个操作映射为带 zod 模式的 MCP 工具
在 mcp-use inspector 中对生成的工具做强制调用与自由发现式两层测试，并部署到 Manufact / mcp-use cloud

输入

OpenAPI 3.x 或 Swagger 2.0 规范文档（openapi.yaml、openapi.json、swagger.json）
规范来源可以是工作区文件路径、URL 或粘贴到对话中的内容
规范中的 securitySchemes 信息及对应的环境变量名称

输出

每个规范操作对应一个 MCP 工具的 MCP 服务器，通过 streamable HTTP 传输运行在 /mcp 端点
解引用后的 openapi.dereferenced.json 文件
可部署到 Manufact / mcp-use cloud 的项目，inspector 位于 http://localhost:<port>/inspector

限制与检查

大型规范（如 Stripe、GitHub 有数百个端点）需要过滤操作范围，生成 200 个不需要的工具会污染 LLM 工具列表并拖慢速度
stdio 服务器无法部署到 Manufact / mcp-use cloud、无法用在线 inspector 测试、无法作为自定义连接器装进 ChatGPT 或 Claude
存在循环引用的规范中 swagger-parser 会保留 $ref，这些引用需在 zod 中作为不透明对象类型处理
若用户希望多数操作都渲染 widget，build-mcp-app 技能通常比本技能更合适，应先向用户指出并确认
解引用后的 openapi.dereferenced.json 中搜索 "$ref"，正常情况下应不存在任何 $ref
用 npx mcp-use client dev tools list 验证工具列表非空；若为空，检查 index.ts 的操作过滤是否清除了所有操作或 openapi.dereferenced.json 是否缺失
在 inspector 聊天页同时做强制调用测试（如 Use list_pets with limit 5）与自由发现式测试（如 Show me the first 5 pets in the store），两层测试均通过才算完成
密钥只能来自环境变量，绝不写入对话或提交到代码库，所需环境变量应记录在 .env.example 中

Openapi To MCP

适用任务

输入

输出

限制与检查

AI 搜索

项目详情