{"type":"mcp_server","name":"supergateway","description":"Supergateway enables running MCP stdio-based servers over SSE or WebSockets, facilitating remote access and debugging with a single command. It supports various configuration options for seamless integration and control.","category":"Communication","language":"TypeScript","stars":2722,"forks":47,"owner":"supercorp-ai","github_url":"https://github.com/supercorp-ai/supergateway","homepage":null,"setup":"## Setup\nRun Supergateway via `npx`: `npx -y supergateway --stdio \"uvx mcp-server-git\"`\n\n**Options:**\n- **`--stdio \"command\"`**: Command that runs an MCP server over stdio\n- **`--sse \"https://mcp-server-ab71a6b2-cd55-49d0-adba-562bc85956e3.supermachine.app\"`**: SSE URL to connect to (SSE→stdio mode)\n- **`--outputTransport stdio | sse | ws`**: Output MCP transport (default: `sse` with `--stdio`, `stdio` with `--sse`)\n- **`--port 8000`**: Port to listen on (stdio→SSE or stdio→WS mode, default: `8000`)\n- **`--baseUrl \"http://localhost:8000\"`**: Base URL for SSE or WS clients (stdio→SSE mode; optional)\n- **`--ssePath \"/sse\"`**: Path for SSE subscriptions (stdio→SSE mode, default: `/sse`)\n- **`--messagePath \"/message\"`**: Path for messages (stdio→SSE or stdio→WS mode, default: `/message`)\n- **`--logLevel info | none`**: Controls logging level (default: `info`). Use `none` to suppress all logs.\n- **`--cors`**: Enable CORS (stdio→SSE or stdio→WS mode)\n- **`--healthEndpoint /healthz`**: Register one or more endpoints (stdio→SSE or stdio→WS mode; can be used multiple times) that respond with `\"ok\"`\n\n**stdio → SSE:**\n`npx -y supergateway --stdio \"npx -y @modelcontextprotocol/server-filesystem ./my-folder\" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message`\n\n**SSE → stdio:**\n`npx -y supergateway --sse \"https://mcp-server-ab71a6b2-cd55-49d0-adba-562bc85956e3.supermachine.app\"`\n\n**stdio → WS:**\n`npx -y supergateway --stdio \"npx -y @modelcontextprotocol/server-filesystem ./my-folder\" --port 8000 --outputTransport ws --messagePath /message`\n\n**Docker:**\n`docker run -it --rm -p 8000:8000 supercorp/supergateway --stdio \"npx -y @modelcontextprotocol/server-filesystem /\" --port 8000`","tools":"## Available Tools\n\n1.  **MCP stdio server to SSE server**: Exposes an MCP stdio server as an SSE server.\n2.  **SSE server to stdio**: Connects to a remote SSE server and exposes it locally via stdio.\n3.  **MCP stdio server to WebSocket server**: Exposes an MCP stdio server as a WebSocket server.\n4.  **MCP Inspector Integration**: Allows listing tools, resources, or performing MCP actions via Supergateway.\n5.  **ngrok Integration**: Shares your local MCP server publicly using ngrok.\n6.  **Docker Support**: Provides a Docker-based workflow to avoid local Node.js setup.\n7.  **Claude Desktop Integration**: Allows Claude Desktop to use Supergateway’s SSE→stdio mode.\n8.  **JSON-RPC versioning**: Automatically manages JSON-RPC versioning.\n9.  **Package metadata retransmission**: Retransmits package metadata where possible.\n10. **Logging**: Provides logging via standard output (stdio→SSE or stdio→WS mode) and stderr (SSE→stdio mode).","faq":null,"created_at":"2024-12-21T12:23:48+00:00","updated_at":"2025-03-28T23:55:59+00:00","source_url":"https://model-context-protocol.com/servers/run-mcp-servers-over-sse-gateway","related_articles":[]}