Swagger API MCP Server

Swagger API MCP服务器

英语 | 中文

MCP（模型上下文协议）服务器，用于解析 Swagger 2.0 和 OpenAPI 3.x 规范，通过MCP工具公开API结构。具有本地文件缓存架构，与内联响应相比，令牌使用率降低了85-95%。

特性

• Swagger 2.0和OpenAPI 3.x --完全支持双格式
• 智能缓存 --Spec解析一次，存储为本地JSON文件；工具返回紧凑的摘要+文件路径（约200个字符对5-20KB）
• 11 MCP工具 --动态加载、浏览、搜索、调用API和管理身份验证
• 3个MCP提示 --用于探索、搜索和集成API的指导性工作流程
• 3 MCP资源 -直接访问缓存的API信息、端点和架构
• 两种运输方式 --stdio（用于CLI/IDE集成）和HTTP（用于多会话web使用）
• 两阶段API调用 --在执行请求之前预览请求
• 零外部分析器 --自定义 $ref 带圆形参考保护的旋转变压器

先决条件

• Node.js>=24

快速开始

从npm安装

npm install -g swagger-api-mcp-server

或者克隆并构建

git clone https://github.com/NekoTarou/swagger-api-mcp-server.git
cd swagger-api-mcp-server
npm install
npm run build

跑

# stdio mode (default) — for MCP clients like Claude Desktop
npm start

# Auto-load a spec on startup
SWAGGER_URL=https://petstore.swagger.io/v2/swagger.json npm start

# HTTP mode — multi-session with Express
npm run start:http

MCP客户端配置

克劳德桌面

添加到您的Claude Desktop配置文件(claude_desktop_config.json):

{
  "mcpServers": {
    "swagger-api": {
      "command": "npx",
      "args": ["-y", "swagger-api-mcp-server"],
      "env": {
        "SWAGGER_URL": "https://petstore.swagger.io/v2/swagger.json"
      }
    }
  }
}

光标/VS代码

添加到MCP设置中：

{
  "mcpServers": {
    "swagger-api": {
      "command": "npx",
      "args": ["-y", "swagger-api-mcp-server"],
      "env": {
        "SWAGGER_URL": "https://your-api.example.com/openapi.json"
      }
    }
  }
}

工具

提示

资源

高速缓存体系结构

加载规范时，它会被解析一次并存储为结构化JSON文件：

.swagger-cache/
├── meta.json              # Cache metadata (URL, counts, timestamp)
├── info.json              # Full API info (title, servers, auth)
├── tags.json              # Tag list with endpoint counts
├── paths-index.json       # Endpoint index for fast lookup
├── schemas-index.json     # Schema index for fast lookup
├── endpoints/             # One file per endpoint (deep-resolved)
│   └── GET__users__{id}.json
└── schemas/               # One file per schema (deep-resolved)
    └── User.json

工具返回带有文件路径的简短摘要。LLM通过 Read 工具--保存 85-95%的代币 每次通话。

环境变量

发展

npm run dev            # Dev mode with auto-reload (tsx watch)
npm test               # Run tests
npm run build          # TypeScript compilation → dist/
npm run clean          # Remove dist/

许可证

麻省理工学院