mcp

为MCP服务快速生成Swagger API文档的集成工具。

安装使用

复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：

帮我安装这个 AI Skill：mcp。
它的用途是：为MCP服务快速生成Swagger API文档的集成工具。
详细介绍见：https://321skill.com/skills/mcp-mcp-swagger/
请根据该页面的说明完成安装。

“请为我的用户管理MCP服务生成Swagger描述。”，它会引导你配置服务路径或解析现有代码，最终输出一个符合OpenAPI规范的YAML或JSON文件，清晰列出所有端点、参数和响应格式。

本Skill旨在解决MCP（Model Context Protocol）服务开发中API文档缺失或维护困难的问题。通过集成Swagger/OpenAPI规范，它能自动或半自动地为MCP服务生成标准化的API描述文档。

使用方式非常便捷。开发者只需在项目中安装并配置此Skill，它便能解析MCP服务的接口定义，自动生成结构清晰的Swagger描述文件。这极大地简化了API文档的创建和维护流程。

它非常适合需要为其MCP服务提供标准化API文档的开发者，尤其是那些希望提升API可发现性、便于团队协作或进行API测试的团队。

使用建议：在项目开发早期集成此工具，有助于建立API设计规范。注意，生成的文档准确性高度依赖于MCP服务接口定义的完整性和规范性，建议结合代码注释或专门的API描述文件以获得最佳效果。

专为MCP服务生态设计，能深度理解MCP的协议结构，生成更贴合MCP服务上下文的API文档，而非通用的Swagger生成器。

不适合为没有明确定义接口或使用非标准协议的非MCP服务生成文档。

这个Skill能自动生成API测试代码吗？

主要功能是生成API描述文档（Swagger/OpenAPI规范），但生成的规范文件可以被其他工具（如Postman、Swagger UI）用于测试。

需要修改现有MCP服务的代码吗？

通常不需要大幅修改代码，但可能需要添加一些符合规范的注释或使用特定的描述符来辅助工具识别接口。