Mcp Swagger Server
About
Converts OpenAPI/Swagger specifications to Model Context Protocol (MCP) format, providing a modern Web UI and a backend service.
Details
- License
- MIT
Explore
- Zero‑configuration conversion from OpenAPI to MCP tools
- Interactive CLI for step‑by‑step setup
- Supports SSE, Streamable, and Stdio transports
- Bearer token authentication for secured APIs
- Operation filtering by HTTP method, path, operation ID, and parameters
Install via npm: npm i mcp-swagger-server -g. Run the interactive CLI with mss, or use command-line flags for non‑interactive startup, e.g., mss --openapi <url> --transport stdio. Configuration can be provided via CLI options, a .env file, or a JSON config file (--config).
<div align="center">
将 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-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 ...）。
快速启动
交互式启动（推荐新手）
```bash mss#### 一键启动（非交互）
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
