A Python MCP server that turns Swagger/OpenAPI documentation into AI-callable tools
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"swagger-mcp-python","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Swagger MCP Server (Python) A Python implementation of a Model Context Protocol (MCP) server that transforms Swagger/OpenAPI documentation into AI-callable tools. This enables AI assistants (like Claude, Gemini) to interact with REST APIs through Swagger documentation. ## Features - **7 MCP Tools**: Same functionality as the TypeScript version - **Multi-service Support**: Configure multiple Swagger endpoints simultaneously - **Auto-authentication**: Cache tokens from 401 responses and auto-inject - **Smart Parameter Completion**: Fill required fields with reasonable defaults - **Network Auto-correction**: Handle localhost vs 127.0.0.1 connectivity issues - **Caching**: 5-minute TTL for Swagger documents with automatic refresh ## Installation ```bash pip install -e . ``` ## Usage ### As an MCP Server Configure in your MCP client (Claude Desktop, Windsurf, etc.): ```json { "mcpServers": { "swagger-python": { "command": "python", "args": [ "-m", "swagger_mcp", "http://localhost:8090/v3/api-docs" ] } } } ``` ### Command Line Arguments - Single service: `http://localhost:8090/v3/api-docs` - Multiple services: `user=http://localhost:8090/v3/api-docs order=http://localhost:8091/v3/api-docs` - Authentication: `auth=admin:123456` or `auth=/login/path:user:pass` ## Available Tools 1. **`list_services`** - List configured Swagger services 2. **`refresh_docs`** - Force refresh cached Swagger documentation 3. **`list_endpoints`** - List all available API endpoints 4. **`search_apis`** - Intelligent fuzzy search with weighted matching 5. **`get_endpoint_details`** - Get complete endpoint definition with parameters and schemas 6. **`debug_endpoint`** - Execute real HTTP requests with auto-authentication and smart parameter completion 7. **`generate_curl`** - Generate cURL commands for API calls ## Development ```bash # Install development dependencies pip install -e ".[dev]" # Run tests pytest # Format code …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.