API MCP Magic
Open APIs specs to MCP server in seconds. Offical project of convertmcp.com
Installation
npx api-mcp-magicAsk AI about API MCP Magic
Powered by Claude Β· Grounded in docs
I know everything about API MCP Magic. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
π Working Live: https://convertmcp.com
Transform OpenAPI/Swagger specifications into production-ready Model Context Protocol (MCP) servers in seconds!
A free, open-source online tool that converts API specifications into MCP servers with support for 10+ programming languages. 100% client-side processing ensures your API specs never leave your browser.
β¨ Features
π― Core Functionality
- Instant Conversion: Transform OpenAPI/Swagger specs to MCP servers in seconds
- Multi-Language Support: Generate code for Python, TypeScript, Go, Rust, Java, Kotlin, C#, PHP, Ruby, and Swift
- Official SDKs: Uses official Model Context Protocol SDKs for each language
- Production-Ready Code: Generated code follows best practices with proper error handling
π Privacy & Security
- 100% Client-Side: All processing happens locally in your browser
- No Server Upload: Your API specifications never leave your device
- No Registration: Free to use, no account required
π Internationalization
- 5 Languages: Full support for English, Italian, French, Spanish, and German
- Auto-Detection: Automatically detects browser language
- Complete Translation: All UI elements, documentation, and blog posts translated
π¨ User Experience
- Multiple Input Methods:
- Upload JSON/YAML files
- Load from URL
- Paste content directly
- Endpoint Selection: Choose which API endpoints to include
- Real-time Preview: See your selection before generating
- Instant Download: Get a ready-to-use ZIP bundle
π Quick Start
Prerequisites
- Node.js 18+ or Bun
- npm, yarn, or bun package manager
Installation
# Clone the repository
git clone https://github.com/walterwootz/api-mcp-magic.git
cd api-mcp-magic
# Install dependencies
npm install
# or
bun install
# Start development server
npm run dev
# or
bun run dev
The application will be available at http://localhost:5173
Build for Production
# Build the application
npm run build
# or
bun run build
# Preview the production build
npm run preview
π οΈ Tech Stack
- Frontend Framework: React 18 with TypeScript
- Build Tool: Vite 5 with SWC
- UI Components: Radix UI + shadcn/ui
- Styling: Tailwind CSS
- Routing: React Router v6
- Internationalization: i18next with browser language detection
- Form Handling: React Hook Form + Zod validation
- Code Generation: Custom generators for 10+ languages
- File Processing: JSZip for bundle creation
π Project Structure
api-mcp-magic/
βββ public/
β βββ icons/ # Language technology logos
β βββ robots.txt
βββ src/
β βββ components/ # React components
β β βββ ui/ # Reusable UI components (shadcn)
β β βββ AnimatedBackground.tsx
β β βββ EndpointSelector.tsx
β β βββ FileUpload.tsx
β β βββ NavLink.tsx
β β βββ TechnologySelector.tsx
β βββ hooks/ # Custom React hooks
β βββ i18n/ # Internationalization
β β βββ config.ts
β β βββ locales/ # Translation files (en, it, fr, es, de)
β βββ lib/ # Utility libraries
β β βββ code-generators.ts # MCP code generation
β β βββ openapi-parser.ts # OpenAPI spec parsing
β β βββ utils.ts
β β βββ zip-generator.ts # ZIP bundle creation
β βββ pages/ # Route pages
β β βββ blog/ # Blog articles
β β βββ Index.tsx
β β βββ NotFound.tsx
β βββ App.tsx
β βββ main.tsx
βββ LICENSE # MIT License
βββ README.md # This file
βββ package.json
π Supported Languages & SDKs
The converter generates production-ready code for:
| Language | SDK | Status |
|---|---|---|
| Python | @modelcontextprotocol/sdk | β Official |
| TypeScript/Node.js | @modelcontextprotocol/sdk | β Official |
| Go | Community SDK | β Supported |
| Rust | Community SDK | β Supported |
| Java | Community SDK | β Supported |
| Kotlin | Community SDK | β Supported |
| C# | Community SDK | β Supported |
| PHP | Community SDK | β Supported |
| Ruby | Community SDK | β Supported |
| Swift | Community SDK | β Supported |
π€ Contributing
Contributions are welcome! Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
Development Guidelines
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Acknowledgments
- Model Context Protocol by Anthropic
- Radix UI for accessible components
- shadcn/ui for beautiful UI components
- Lucide Icons for icons
- All contributors and users of this tool
π¬ Support
- Issues: GitHub Issues
π Star History
If you find this project useful, please consider giving it a star β
Deploy to any static hosting
This is a static React application that can be deployed to:
- Vercel
- Netlify
- GitHub Pages
- Cloudflare Pages
- Any static hosting service
