swagger-mcp-tools

[](https://www.npmjs.com/package/swagger-mcp-tools) [](https://www.npmjs.com/package/swagger-mcp-tools) [](https://github.com/dyq086/swagger-mcp-tools/blob/main/LICENSE)

一个用于 Cursor 等 MCP (Model Context Protocol) 客户端的 Swagger/OpenAPI 文档查询工具。通过 MCP 协议，AI 助手可以轻松查询和分析 Swagger API 文档，获取接口类型信息。

swagger-mcp-tools 是一个 MCP 服务器，它可以将 Swagger/OpenAPI 文档转换为 MCP 工具，让 AI 助手（如 Cursor）能够：

• 📚 浏览和搜索 API 文档
• 🔍 查询接口的详细类型信息
• 💡 在编写代码时获取准确的 API 类型定义
• 🚀 提高开发效率，减少查阅文档的时间

• 🔍 模块查询 - 获取 Swagger API 的所有模块列表
• 📋 接口列表 - 获取指定模块下的所有接口
• 📝 类型信息 - 获取接口的详细类型信息（参数、请求体、响应类型）
• 🔄 多格式支持 - 支持 Swagger 2.0 和 OpenAPI 3.0 格式
• ⚙️ 灵活配置 - 支持配置文件、环境变量等多种配置方式

无需全局安装，直接使用 npx 运行：

# 无需安装，直接使用 npx
npx swagger-mcp-tools

如果需要全局安装：

npm install -g swagger-mcp-tools
# 或
yarn global add swagger-mcp-tools

git clone https://github.com/dyq086/swagger-mcp-tools.git
cd swagger-mcp-tools
npm install
npm run build

构建完成后，可以使用以下方式运行：

# 直接运行构建后的文件
node dist/mcp-server.js

# 或使用 npm link 进行本地开发
npm link
swagger-mcp-tools

在 Cursor 的 MCP 配置文件中（通常是 ~/.cursor/mcp.json 或项目根目录的 .cursor/mcp.json）添加：

{
  "mcpServers": {
    "swagger": {
      "command": "npx",
      "args": ["swagger-mcp-tools@latest"],
      "env": {
        "SWAGGER_URL": "http://your-api.com/v3/api-docs",
        "SWAGGER_TOKEN": "your-token-here"
      }
    }
  }
}

在项目根目录创建 .swagger-mcp.json：

{
  "swaggerUrl": "http://your-api.com/v3/api-docs",
  "token": "your-token-here"
}

然后在 MCP 配置中使用：

{
  "mcpServers": {
    "swagger": {
      "command": "npx",
      "args": ["swagger-mcp-tools@latest"]
    }
  }
}