Universal Swagger → MCP Server Converter

Stop wrestling with massive API docs in your AI assistant's context window. Start having intelligent conversations about any API.

🚀 Quick Start View Source 📚 Documentation

✅ CI passing 📄 License MIT 🐍 python 3.11+ 🔌 MCP Compatible 🎯 Cursor Ready 🤖 Claude Integration 📦 VS Code Extension

0 ★ STARS

10x Faster Integration

<200ms Response Time

✨ NEW UPDATE

Organized Project Structure

All generated MCP servers are now automatically organized in a dedicated generated-mcp-servers/ directory for better project management.

Clean Organization

✓ Dedicated directory for all generated servers
✓ Automatic .gitignore management
✓ Easy cleanup and server management
✓ Updated CLI examples and documentation

New Directory Structure

your-project/
├── generated-mcp-servers/
│   ├── mcp-server-api1/
│   ├── mcp-server-api2/
│   └── mcp-server-ozon/
└── your-source-code/

Get Started in 30 Seconds

Transform any Swagger/OpenAPI specification into an intelligent MCP server

                # 1. Convert any Swagger file to intelligent MCP server
                swagger-mcp-server convert your-api.json
                📁 Output: generated-mcp-servers/mcp-server-your-api
                
                # 2. Start the generated server
                cd generated-mcp-servers/mcp-server-your-api
                python server.py
                
                # 3. Connect to Cursor, Claude, or VS Code
                # Your AI assistant now knows EVERYTHING about your API
                
                # 4. Start building with superhuman API knowledge
                AI: "Create a React hook for user authentication with retry logic"
                AI: "Generate Python client for the payment endpoints"
                AI: "Show me all endpoints that return user data"
            

Why Choose Our Solution?

Solve the API documentation problem that every developer faces

🔍

Intelligent Search

Find relevant endpoints using natural language queries. No more scrolling through massive documentation.

⚡

Lightning Fast

Sub-200ms search responses optimized for AI agent workflows. Real-time API exploration.

🤖

AI-First Design

Built specifically for AI coding assistants. Works with VS Code, Cursor, Claude, and any MCP-compatible tool.

📊

Schema Awareness

Complete type information and relationships preserved. Your AI understands the full API context.

💻

Code Generation

Generate working examples in multiple languages: cURL, JavaScript, Python, TypeScript, and more.

📁

Organized Structure

Clean project organization with dedicated generated-mcp-servers/ directory. Easy management of multiple API servers.

🛡️

Enterprise Ready

SSL, authentication, monitoring, and deployment guides. Handles massive APIs (10MB+) offline.

⭐ Love this project? Give it a star! ⭐

🚀 Help us reach more developers who struggle with API integrations! Your star makes this project more discoverable and motivates continued development.

⭐ Star this repo 🍴 Fork it 📢 Share it