// ❌ Without Gateway: 3 entries in claude_desktop_config.json
{
  "weather": { "command": "...", "args": ["weather_server.py"] },
  "sqlite": { "command": "...", "args": ["sqlite_server.py", "--db-path", "..."] },
  "filesystem": { "command": "...", "args": ["filesystem_server.py", "--sandbox", "..."] }
}

// ✅ With Gateway: 1 entry — register/unregister servers at runtime
{
  "gateway": { "command": "python", "args": ["gateway.py"] }
}

# 1. Setup
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 2. Start the gateway
python gateway.py

# 3. Register backend servers (from MCP client)
register_server(name="weather", command="python", args="weather_server.py", description="Weather alerts")
register_server(name="sqlite", command="python", args="sqlite_server.py --db-path /tmp/sample.db", description="Database queries")

python gateway.py --auto-register gateway-config.json

{
  "mcpServers": {
    "gateway": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/mcp-multi-server-gateway/gateway.py"]
    }
  }
}

python gateway.py --transport streamable-http --port 8003

mcp-multi-server-gateway/
├── gateway.py              # Main gateway server (FastMCP + asyncio)
├── gateway-config.json     # Example auto-registration config
├── requirements.txt
├── setup.sh
├── README.md
└── .gitignore

         ┌─────────────────────────────────────┐
         │       MCP Client (Claude, etc)       │
         └──────────────┬──────────────────────┘
                        │  single MCP connection
         ┌──────────────▼──────────────────────┐
         │     MCP Multi-Server Gateway         │
         │     (gateway.py on :8003)            │
         │                                      │
         │  register / call_backend / pipeline  │
         └──┬──────────┬──────────┬───────────┘
            │          │          │
     ┌──────▼──┐ ┌─────▼────┐ ┌──▼────────┐
     │ Weather  │ │  SQLite  │ │ FileSystem│
     │ Server   │ │  Server  │ │  Server   │
     └─────────┘ └──────────┘ └───────────┘