MCP Swagger Server(mss)
将 OpenAPI/Swagger 规范转换为 Model Context Protocol (MCP) 格式的工具
零配置将您的 REST API 转换为 AI 可调用的工具
🚀 快速开始 • 📖 使用指南 • 🛠️ 开发
Languages: English | 中文
🎬 快速演示
🎯 项目截图
🎯 项目简介
MCP Swagger Server 是一个将 OpenAPI/Swagger 规范转换为 Model Context Protocol (MCP) 格式的工具。
📦 项目结构
mcp-swagger-server/
├── packages/
│ ├── mcp-swagger-server/ # 🔧 核心 MCP 服务器 (可用)
│ ├── mcp-swagger-parser/ # 📝 OpenAPI 解析器 (可用)
│ └── mcp-swagger-api/ # 🔗 REST API 后端 (可用)
└── scripts/ # 🔨 构建脚本✨ 核心特性
- 🔄 零配置转换: 输入 OpenAPI 规范，立即获得 MCP 工具
- 🎯 渐进式命令行: 提供逐步引导的命令行界面，方便用户配置
- 🖥️ 终端优先体验: 以 CLI / 交互式终端作为主要使用方式
- 🔌 多传输协议: 支持 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-token "your-token-here"
# 使用配置文件
mss --config config.json
