SuperMCP starts
  └─ reads SUPERMCP_REGISTRY   (env var, or from .env file)
       └─ points to a registry file anywhere on disk
            └─ loads mcpServers from that file
                 └─ resolves relative paths from the registry's directory

git clone https://github.com/YakupAtahanov/SuperMCP.git
cd SuperMCP
uv pip install "mcp[cli]"

cp .env.example .env

SUPERMCP_REGISTRY=C:/Users/you/my-servers/mcp.json

SUPERMCP_REGISTRY=/path/to/mcp.json python SuperMCP.py

{
  "command": "python",
  "args": ["C:/path/to/SuperMCP.py"],
  "env": { "SUPERMCP_REGISTRY": "C:/Users/you/my-servers/mcp.json" }
}

{
  "mcpServers": {
    "ShellMCP": {
      "command": "python",
      "args": [".mcps/ShellMCP/server.py"],
      "type": "stdio",
      "description": "Shell command execution",
      "enabled": true
    }
  }
}

python SuperMCP.py

{
  "mcpServers": {
    "my-server": {
      "command": "python",
      "args": ["path/to/server.py"],
      "type": "stdio",
      "description": "A local MCP server",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "remote-server": {
      "url": "https://example.com/mcp/sse",
      "type": "sse",
      "description": "A remote SSE server",
      "enabled": true,
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

{
  "mcpServers": {
    "weather-mcp": {
      "command": "python",
      "args": [".mcps/remote/weather-mcp/server.py"],
      "type": "stdio",
      "url": "https://github.com/user/weather-mcp.git",
      "description": "Cloned from Git, runs locally",
      "enabled": true
    }
  }
}

SuperMCP/
├── SuperMCP.py          # Main orchestration server
├── server_manager.py    # Git cloning, SSE testing, dependency install
├── .env.example         # Template — copy to .env and set SUPERMCP_REGISTRY
├── pyproject.toml       # Python dependencies
├── ARCHITECTURE.md      # Architecture overview
└── README.md