SuperGateway 介绍

What is SuperGateway?

SuperGateway is a gateway tool that converts standard input/output (stdio) into Server-Sent Events (SSE). It allows you to run stdio-based MCP (Model Context Protocol) servers and access them remotely via SSE.

How to use SuperGateway?

Build the project with Maven (Java 17+, Maven 3.6+), then run the JAR with command-line options specifying the stdio command, port, base URL, SSE path, and message path. For example: java -jar supergateway-1.0.0.jar --stdio "java -jar your-mcp-server.jar" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message.

Key features

• Converts stdio-based MCP servers to SSE services
• Supports multiple simultaneous client connections
• Automatically detects and forwards JSON-formatted output
• Supports CORS
• Includes health check endpoints
• Configurable log levels (info or none)

Use cases

• Remotely accessing a local stdio-based MCP server over HTTP/SSE
• Enabling multiple clients to interact with one MCP server concurrently
• Integrating an MCP server into a web-based architecture

FAQ from SuperGateway

What is the purpose of SuperGateway?

It bridges stdio-based MCP servers to SSE, allowing remote access without modifying the original server.

What are the runtime requirements?

Java 17 or higher and Maven 3.6 or higher are required to build and run.

How does SuperGateway handle client sessions?

Each SSE client automatically receives a unique sessionId, which must be used when sending messages to the process.

Are there any limits on message format?

The process output must be valid JSON to be forwarded to SSE clients, and all incoming messages must also be valid JSON.

Which transports or authentication are supported?

SuperGateway uses stdio-to-SSE transport. No authentication mechanism is documented; CORS can be enabled via the --cors flag.