Supergateway

What is Supergateway?

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. It is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

How to use Supergateway?

Run Supergateway via npx -y supergateway --stdio "command" to expose a stdio server as an SSE or WS endpoint. Alternatively, use --sse or --streamableHttp to connect to remote servers and expose locally over stdio. A Docker image is also available at supercorp/supergateway.

Key features of Supergateway

• Converts stdio MCP servers to SSE, WebSocket, or Streamable HTTP
• Supports SSE→stdio and Streamable HTTP→stdio modes
• Configurable ports, paths, headers, CORS, and logging levels
• Ready-to-run Docker images with optional dependencies (uvx, deno)
• Integrates with Claude Desktop, Cursor, and ngrok

Use cases of Supergateway

• Expose a local stdio MCP server for remote web-based clients
• Connect to a remote SSE MCP server from a local command-line environment
• Debug MCP servers using MCP Inspector via Supergateway
• Share a local MCP server publicly using ngrok
• Run MCP servers in Docker without local Node.js setup

FAQ from Supergateway

How do I install Supergateway?

Run npx -y supergateway (Node.js required) or use the Docker image supercorp/supergateway.

Can I use authentication headers?

Yes, use --header "key: value" for custom headers and --oauth2Bearer "token" to add an Authorization Bearer header.

Which MCP transports does Supergateway support?

It supports stdio, SSE, WebSocket, and Streamable HTTP as input or output transports.

Can I use Supergateway with Claude Desktop or Cursor?

Yes, configure it in SSE→stdio mode using npx or Docker in your client’s MCP settings.

Does Supergateway support CORS?

Yes, enable CORS with --cors (allow all origins) or specify allowed origins (e.g., --cors "http://example.com").