# ⚡ Instant-MCP Studio
### Autonomous Zero-Cost OpenAPI & REST to Production FastMCP Server Generator

[![FastMCP Compatible](https://img.shields.io/badge/FastMCP-v1.0-teal?style=for-the-badge&logo=python)](https://github.com/modelcontextprotocol)
[![Zero Cost](https://img.shields.io/badge/Cost-$0%20Zero%20API%20Fees-emerald?style=for-the-badge)](https://github.com/MojoRohjo/instant-mcp-generator)
[![Claude Desktop Ready](https://img.shields.io/badge/Claude%20Desktop-1--Click%20Inject-indigo?style=for-the-badge)](https://claude.ai)

**Instant-MCP Studio** turns any OpenAPI v3.1 / v3.0 / Swagger 2.0 specification (JSON, YAML, or live URL) into a production-ready, type-safe **FastMCP Python Server** in 1 second — with a sleek Glassmorphism Localhost Studio and 1-click Claude Desktop / Cursor IDE integration.

---

## 🌟 Why Instant-MCP?

Existing OpenAPI generators suffer from major flaws:
- ❌ **Token Bankruptcy:** Dumping 150 tools into Claude's context window, causing tool-call failures.
- ❌ **Stdout Pollution:** Terminal print statements that corrupt JSON-RPC streams and crash Claude Desktop.
- ❌ **Manual Config Headaches:** Wrestling with Windows/Mac JSON paths and escaping errors.

**Instant-MCP solves this with:**
- ✅ **Smart Endpoint Pruning:** Select only the 5-10 tools you need with visual checkboxes.
- ✅ **1-Click Claude & Cursor Injection:** Auto-writes `%APPDATA%\Claude\claude_desktop_config.json` with zero path errors.
- ✅ **Zero-Cost Local Studio:** Runs 100% locally with a dark-mode Monaco Code Editor.
- ✅ **Circular Reference Defense:** Robust cycle-aware parser that prevents recursion errors.

---

## 🚀 Quickstart

### 1. Launch the Web Studio
```bash
python -m instant_mcp.cli studio --port 8765
```
Open **`http://127.0.0.1:8765`** in your browser.

### 2. Or Generate from CLI
```bash
python -m instant_mcp.cli generate https://petstore.swagger.io/v2/swagger.json --output ./petstore_mcp.py --install-claude
```

---

## 🏗️ Architecture

```mermaid
graph TD
    A[OpenAPI / Swagger JSON] --> B[Cycle-Aware AST Parser]
    B --> C[Intermediate Representation IR]
    C --> D[Smart Endpoint Filter]
    D --> E[Jinja2 + Pydantic FastMCP Codegen]
    E --> F[1-Click Claude Desktop / Cursor Injector]
    E --> G[Live Monaco Studio Preview]
```

---

## 👤 Author
**Mohit Yadav (@MojoRohjo)**  
Building AI-Powered Search Engines & MCP Workflows.  
- GitHub: [@MojoRohjo](https://github.com/MojoRohjo)  
- LinkedIn: [Mohit Yadav](https://www.linkedin.com/in/mohit-kr-yadav/)  
- Twitter: [@MOHIT_0101](https://x.com/MOHIT_0101)