swagger-mcp

swagger-mcp

17

Swagger Explorer MCP is a Management Control Plane server designed to facilitate the exploration and analysis of Swagger/OpenAPI specifications via Claude. It features authentication support, custom response formatting, and schema analysis capabilities.

Swagger Explorer MCP

A Management Control Plane (MCP) server for exploring and analyzing Swagger/OpenAPI specifications through Claude.

Features

  • Authentication Support: Bearer token authentication, configurable through environment variables.
  • Custom Response Formatting
    • Minimal, Detailed, and Raw formats.
  • Schema Analysis
    • Detailed property exploration and schema relationships.
  • API Exploration
    • Path listing, method filtering, and response format analysis.

Quick Start

Install and run globally using npx. Alternatively, configure with environment variables.

Usage with Claude

Interact with the Swagger documentation using Claude to explore endpoints, analyze specific endpoints, and view schema details.

Configuration

  • BASE_URL: Base path for the API.
  • AUTH_TOKEN: Bearer token for authentication.
  • PORT: Server port.
  • SWAGGER_URL: Default Swagger documentation URL.

Common Use Cases

  • API Documentation Review
  • Schema Validation
  • Response Analysis
  • Integration Planning

Troubleshooting

Ensure URLs and authentication tokens are correct, verify ports, and check schema names.