swagger-viewer

swagger-viewer

3.2

Swagger Viewer MCP Tool is designed for the Cursor editor to facilitate quick viewing and utilization of Swagger API documentation.

Swagger Viewer MCP 工具

这是一个用于 Cursor 编辑器的 MCP 工具,可以帮助你快速查看和使用 Swagger API 文档。

功能特点

  • 自动读取用户根目录下的 swagger.json 配置文件
  • 实时监控配置文件变化,自动更新 API 文档
  • 支持模糊搜索 API 接口
  • 自动生成接口调用代码
  • 支持查看所有可用接口

安装

npm install

配置

在用户根目录下创建 swagger.json 文件,格式如下:

{
    "swaggerUrl": "https://your-swagger-api-url/swagger.json"
}

npx:

"swagger-viewer": {
      "command": "cmd",
      "swagger-viewer": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@xc_angelwatch/swagger-viewer"]
    }
}

使用方法

该工具提供以下 MCP 接口:

  1. mcp_swagger_initialize(): 初始化工具,加载配置
  2. mcp_swagger_search(query): 搜索接口
  3. mcp_swagger_generate_code(path, method, language): 生成接口调用代码
  4. mcp_swagger_get_all_endpoints(): 获取所有可用接口

示例用法

// 初始化
await mcp_swagger_initialize();

// 搜索包含 "user" 的接口
const results = await mcp_swagger_search("user");

// 生成特定接口的代码
const code = await mcp_swagger_generate_code("/api/users", "GET", "javascript");

// 获取所有接口
const endpoints = await mcp_swagger_get_all_endpoints();

配置文件监控

工具会自动监控用户根目录下的 swagger.json 文件变化。当文件发生变化时,会自动重新加载最新的 API 文档。

支持的编程语言

目前支持生成以下语言的代码: