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.
Supergateway bridges MCP stdio-based servers with SSE or WebSockets, enabling remote access and debugging. It's supported by Supermachine, Superinterface, and Supercorp.
Installation is simplified via npx
, with options to define the stdio command, SSE URL, output transport (stdio
, sse
, ws
), port, base URL, and paths for SSE subscriptions and messages. It supports CORS and health endpoints.
Supergateway facilitates three primary modes: stdio to SSE, exposing a local MCP server as an SSE endpoint; SSE to stdio, connecting to a remote SSE server and exposing it locally via stdio; and stdio to WS, exposing an MCP stdio server as a WebSocket server. Examples include integration with MCP Inspector and ngrok for public sharing. Docker images are available for containerized deployments. It's compatible with Claude Desktop using both NPX and Docker-based MCP server configurations. Supergateway leverages the Model Context Protocol, standardizing AI tool interactions and simplifying integration with web-based clients.
supercorp-ai/supergateway
December 21, 2024
March 28, 2025
TypeScript