swagger

将OpenAPI/Swagger规范自动转换为MCP服务器,助力LLM对接REST API。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:swagger。
它的用途是:将OpenAPI/Swagger规范自动转换为MCP服务器,助力LLM对接REST API。
完整的 Skill 内容见:https://321skill.com/skills/swagger-swagger-to-mcp-generator/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我调用用户管理API,查询ID为123的用户信息。” 它会通过你配置好的MCP服务器,自动向你的后端服务发起请求,并返回结构化的用户数据。或者,你可以说:“根据订单API的规范,生成一个创建新订单的示例请求代码。” AI会利用已接入的API工具,提供准确的代码片段。

介绍

该工具旨在解决LLM(大型语言模型)与现有REST API系统对接困难、开发成本高的问题。通过解析标准的OpenAPI或Swagger规范文件,它可以自动生成一个符合MCP(Model Context Protocol)标准的服务器,从而让LLM能够安全、结构化地调用这些API。

使用时,开发者只需提供API的规范文件,运行工具即可生成对应的MCP服务器代码。之后,在支持MCP的AI平台(如Claude Desktop)中配置此服务器,AI助手便能直接查询和使用这些API,无需开发者手动编写复杂的集成代码。

它非常适合需要将AI能力快速集成到现有产品后端、或希望让AI助手协助进行API测试与调试的开发者。无论是后端开发、全栈开发还是智能体开发者,都能通过此工具显著提升工作效率。

建议在使用前确保你的API规范文件完整且准确。由于工具基于规范生成,API文档的质量直接决定了生成结果的好坏。对于高度定制化或非标准的API调用逻辑,可能需要在生成的代码基础上进行二次开发。

核心特点

此工具专为MCP协议设计,能直接将API规范转化为AI可用的工具,而同类工具多专注于生成客户端SDK或文档。它实现了从API描述到AI Agent可执行工具的端到端自动化,无需中间转换层。

注意事项

不适合处理非RESTful风格(如GraphQL、gRPC)或文档不规范、不完整的API。

常见问题

这个工具支持哪些OpenAPI版本?

通常支持OpenAPI 3.0及以上版本,具体请查看项目文档。

生成的MCP服务器需要部署吗?

通常作为本地服务运行,供Claude Desktop等MCP客户端连接使用,无需公网部署。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/swagger-swagger-to-mcp-generator/raw/index.md 读取 swagger 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。