mcp-swagger-server

<div align="center">

[](https://www.typescriptlang.org/) [](https://nodejs.org/) [](LICENSE) [](https://archestra.ai/mcp-catalog/zaizaizhao__mcp-swagger-server)

将 OpenAPI/Swagger 规范转换为 Model Context Protocol (MCP) 格式的工具

零配置将您的 REST API 转换为 AI 可调用的工具

🚀 快速开始 • 📖 使用指南 • 🛠️ 开发

Languages: English | 中文

</div>

---

MCP Swagger Server 是一个将 OpenAPI/Swagger 规范转换为 Model Context Protocol (MCP) 格式的工具。

mcp-swagger-server/
├── packages/
│   ├── mcp-swagger-server/     # 🔧 核心 MCP 服务器 (可用)
│   ├── mcp-swagger-parser/     # 📝 OpenAPI 解析器 (可用)
│   ├── mcp-swagger-ui/         # 🎨 Web 界面 (开发中)
│   └── mcp-swagger-api/        # 🔗 REST API 后端 (可用)
└── scripts/                    # 🔨 构建脚本

• 🔄 零配置转换: 输入 OpenAPI 规范，立即获得 MCP 工具
• 🎯 渐进式命令行: 提供逐步引导的命令行界面，方便用户配置
• 🔌 多传输协议: 支持 SSE、Streamable 和 Stdio 传输
• 🔐 安全认证: 支持 Bearer Token 认证保护 API 访问

• Node.js ≥ 20.0.0
• pnpm ≥ 8.0.0 (推荐)

npm i mcp-swagger-server -g

• mss：交互式终端界面（默认）
• mcp-swagger-server / mcp-swagger：标准命令行（适合脚本和 AI 客户端集成）
• mss --openapi ...：直接启动模式（跳过交互界面）

> 说明：交互式会话模式下不支持 STDIO 启动；如需 STDIO，请使用 mss --openapi ... --transport stdio（兼容别名：mcp-swagger-server --transport stdio ...）。

mss

mss --openapi https://api.example.com/openapi.json \
  --operation-filter-methods GET \
  --operation-filter-methods POST \
  --transport streamable \
  --auth-type bearer \
  --bearer-tok