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.