Skip to main content
Glama
enesjakozh

Swagger Explorer MCP

by johnneerdael
GitHub
TypeScript
17
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Swagger Explorer MCP

用于通过 Claude 探索和分析 Swagger/OpenAPI 规范的管理控制平面 (MCP) 服务器。

快速入门

使用 npx 全局安装并运行：

npx -y @johnneerdael/swagger-mcp

或者使用环境变量安装：

npx -y @johnneerdael/swagger-mcp \ --env BASE_URL=/api \ --env AUTH_TOKEN=your-token \ --env PORT=3000

Claude Desktop 安装

  1. 打开 Claude 桌面

  2. 点击“设置”（齿轮图标）

  3. 选择“工具和集成”

  4. 点击“添加 MCP 服务器”

  5. 输入以下内容：

    Name: Swagger Explorer Command: npx -y @johnneerdael/swagger-mcp Arguments: --swagger-url=$SWAGGER_URL

  6. 点击“安装”

与 Claude 一起使用

以下是与 Claude 互动的一些示例：

Swagger 基本探索

Human: Can you explore the Swagger documentation at http://localhost:8080/docs? Claude: I'll help you explore that Swagger documentation using the Swagger Explorer MCP. Let me analyze the API endpoints and schemas for you: [Claude would then use the MCP to fetch and analyze the Swagger documentation]

分析特定端点

Human: What are the available response schemas for the /pets POST endpoint? Claude: I'll check the response schemas for that endpoint using the MCP. [Claude would use the MCP to fetch specific endpoint details]

模式分析

Human: Can you show me the detailed structure of the Pet schema? Claude: I'll retrieve the detailed schema information using the MCP. [Claude would use the MCP to analyze the schema structure]

特征

  1. 身份验证支持

    • 持有者令牌身份验证

    • 可通过环境变量配置

  2. 自定义响应格式

    • 最小格式：删除空值

    • 详细格式：包括元数据和时间戳

    • 原始格式：未修改的响应

  3. 模式分析

    • 详细的财产勘探

    • 响应模式分析

    • 架构关系

  4. API探索

    • 路径列表

    • 方法过滤

    • 响应格式分析

配置

环境变量：

  • BASE_URL ：API 的基本路径（默认值：''）

  • AUTH_TOKEN ：用于身份验证的承载令牌

  • PORT ：服务器端口（默认值：3000）

  • SWAGGER_URL ：默认 Swagger 文档 URL

API 端点

探索 API

curl -X POST http://localhost:3000/api/explore \ -H "Authorization: Bearer your-token" \ -H "Content-Type: application/json" \ -d '{ "url": "http://your-swagger-url", "options": { "paths": true, "schemas": true } }'

获取架构详细信息

curl -X POST http://localhost:3000/api/schema-details \ -H "Authorization: Bearer your-token" \ -H "Content-Type: application/json" \ -d '{ "url": "http://your-swagger-url", "schemaName": "Pet" }'

获取响应模式

curl -X POST http://localhost:3000/api/response-schemas \ -H "Authorization: Bearer your-token" \ -H "Content-Type: application/json" \ -d '{ "url": "http://your-swagger-url", "path": "/pets", "method": "post" }'

响应格式

最小格式

{ "status": "success", "data": { // Only non-null values } }

详细格式

{ "status": "success", "timestamp": "2025-01-29T10:00:00.000Z", "data": { // Full response }, "metadata": { "version": "1.0", "format": "detailed" } }

常见用例

  1. API 文档审查

    Human: Can you summarize all the available endpoints and their purposes?

  2. 模式验证

    Human: What fields are required for creating a new pet?

  3. 响应分析

    Human: What are the possible error responses for the login endpoint?

  4. 整合规划

    Human: How should I structure my request to create a new order?

故障排除

  1. 连接问题

    • 确保 Swagger URL 可访问

    • 检查身份验证令牌是否正确

    • 验证端口未被使用

  2. 授权错误

    • 验证 AUTH_TOKEN 是否设置正确

    • 确保请求中包含持有者令牌

  3. 未找到架构

    • 检查架构名称是否完全匹配

    • 验证 Swagger 规范是否已正确加载

安全说明

  1. 如果设置了 AUTH_TOKEN，MCP 需要身份验证

  2. 所有请求均已记录以供调试

  3. 敏感信息不被缓存

  4. 限制速率以防止滥用

发展

贡献或修改：

  1. 克隆存储库

  2. 安装依赖项：

    npm install

  3. 建造：

    npm run build

  4. 本地运行：

    npm start

执照

MIT 许可证 - 详情请参阅许可证文件

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

管理控制平面服务器允许用户探索和分析 Swagger/OpenAPI 规范，提供端点探索、模式分析和可定制响应格式等功能，并支持身份验证和与 Claude 等工具的集成。

  1. 快速入门
    1. Claude Desktop 安装
      1. 与 Claude 一起使用
        1. Swagger 基本探索
        2. 分析特定端点
        3. 模式分析
      2. 特征
        1. 配置
          1. API 端点
            1. 探索 API
            2. 获取架构详细信息
            3. 获取响应模式
          2. 响应格式
            1. 最小格式
            2. 详细格式
          3. 常见用例
            1. 故障排除
              1. 安全说明
                1. 发展
                  1. 执照

                    Related Resources

                    Related MCP Servers

                    • Swagger MCP Server

                      dcolley
                      -
                      security
                      -
                      license
                      -
                      quality
                      A server that enables interaction with any API that has a Swagger/OpenAPI specification through Model Context Protocol (MCP), automatically generating tools from API endpoints and supporting multiple authentication methods.
                      Last updated -
                      35
                      104
                      Apache 2.0

                    • Swagger MCP

                      Vizioz
                      A
                      security
                      -
                      license
                      A
                      quality
                      An MCP server that connects to a Swagger specification and helps an AI to build all the required models to generate a MCP server for that service.
                      Last updated -
                      5
                      35
                      81
                      MIT License
                      • Linux
                      • Apple

                    • OpenAPI Schema Explorer

                      kadykov
                      A
                      security
                      -
                      license
                      A
                      quality
                      MCP server providing token-efficient access to OpenAPI/Swagger specs via MCP Resources for client-side exploration.
                      Last updated -
                      22
                      55
                      MIT License

                    • OpenAPI to MCP Server

                      TykTechnologies
                      A
                      security
                      -
                      license
                      A
                      quality
                      A tool that creates MCP (Model Context Protocol) servers from OpenAPI/Swagger specifications, enabling AI assistants to interact with your APIs.
                      Last updated -
                      3
                      20
                      25
                      MIT License
                      • Apple

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/johnneerdael/swagger-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server