{"repo":"zaizaizhao/mcp-swagger-server","free":true,"listed":false,"github":"https://github.com/zaizaizhao/mcp-swagger-server","clone":"git clone https://github.com/zaizaizhao/mcp-swagger-server.git","description":"MCP Swagger Server 将任何符合 OpenAPI/Swagger 规范的 REST API 转换为 Model Context Protocol (MCP) 格式，让 AI 助手能够理解和调用您的 API。","language":"TypeScript","stars":74,"topics":["mcp","openapi","swagger","mcpserver","openapi-mcp","swagger-mcp"],"license":"MIT","category":"mcp-servers","readme_excerpt":"MCP Swagger Server(mss) 将 OpenAPI/Swagger 规范转换为 Model Context Protocol (MCP) 格式的工具 零配置将您的 REST API 转换为 AI 可调用的工具 🚀 快速开始 • 📖 使用指南 • 🛠️ 开发 Languages : English 中文 --- 🎬 快速演示 🎯 项目截图 🎯 项目简介 MCP Swagger Server 是一个将 OpenAPI/Swagger 规范转换为 Model Context Protocol (MCP) 格式的工具。 📦 项目结构 ✨ 核心特性 - 🔄 零配置转换 : 输入 OpenAPI 规范，立即获得 MCP 工具 - 🎯 渐进式命令行 : 提供逐步引导的命令行界面，方便用户配置 - 🖥️ 终端优先体验 : 以 CLI / 交互式终端作为主要使用方式 - 🔌 多传输协议 : 支持 SSE、Streamable 和 Stdio 传输 - 🔐 安全认证 : 支持 Bearer Token 认证保护 API 访问 🚀 快速开始 环境要求 - Node.js ≥ 20.0.0 - pnpm ≥ 8.0.0 (推荐) 安装 命令说明 - mss ：交互式终端界面（默认） - mcp-swagger-server / mcp-swagger ：标准命令行（适合脚本和 AI 客户端集成） - mss --openapi ... ：直接启动模式（跳过交互界面） 说明：交互式会话模式下不支持 STDIO 启动；如需 STDIO，请使用 mss --openapi ... --transport stdio （兼容别名： mcp-swagger-server --transport stdio ... ）。 快速启动 交互式启动（推荐新手） 一键启动（非交互） 📖 使用指南 命令行选项 提示：如果要在 mss 中直接启动（跳过交互界面），请显式传入 --openapi 参数。若 OpenAPI 文档中的 servers.url 是相对路径（如 /v1 ），请优先使用远程 URL 加载文档，或显式传入 --base-url 。Swagger 2.0 文档会在启动时自动转换为 OpenAPI 3.x（含 host/basePath 映射）。 Xquik API Key 请求头示例 🔐 Bearer Token 认证 mcp-swagger-server 支持 Bearer Token 认证，可以保护需要身份验证的 API 访问。 认证方式 1. 直接指定 Token 环境变量配置 创建 .env 文件： 🤖 与 AI 助手集成 Claude Desktop 配置 🛠️ 开发 构建系统 🤝 贡献 欢迎贡献！请先阅读 贡献指南。 📄 许可证 MIT License - 详见 LICENSE 文件。 --- Built with ❤️ by ZhaoYaNan(ZTE) ⭐ Star • 🐛 Issues • 💬 Discussions","default_branch":null,"files":null,"tree":[],"storefront":"/r/zaizaizhao","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/zaizaizhao/mcp-swagger-server/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}