supergateway

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.

1,005
47

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.

Repository

SU
supercorp-ai

supercorp-ai/supergateway

Created

December 21, 2024

Updated

March 28, 2025

Language

TypeScript

Category

Communication