MCP Swagger Server(mss)

<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

#### 一键启动（非交互）

bash 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"