SuperGateway logo

SuperGateway

by coding-alt

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

View on GitHub

Last updated: N/A

What is SuperGateway?

SuperGateway is a gateway tool that transforms standard input/output (stdio) into Server-Sent Events (SSE). It enables remote access to stdio-based MCP (Model Context Protocol) servers through SSE.

How to use SuperGateway?

First, build the project using Maven (mvn clean package). Then, run the application using java -jar target/supergateway-1.0.0.jar [options]. Configure the necessary command-line options, such as the MCP server command, SSE URL, and port.

Key features of SuperGateway

  • Converts stdio-based MCP servers to SSE services

  • Supports multiple concurrent client connections

  • Automatically identifies and forwards JSON-formatted output

  • Supports CORS

  • Provides a health check endpoint

  • Configurable log levels

Use cases of SuperGateway

  • Remotely accessing MCP servers through SSE

  • Exposing stdio-based applications as SSE services

  • Building real-time communication systems with stdio applications

  • Monitoring and controlling stdio processes via SSE

FAQ from SuperGateway

What is the required Java version?

Java 17 or higher is required.

How do I build the project?

Use Maven with the command mvn clean package in the src/java directory.

How do I enable CORS?

Use the --cors command-line option.

What format should the process output be in?

The process output must be in JSON format to be forwarded to the SSE client.

How do I send a message to the process?

Send a POST request to the /message endpoint with the session ID and a JSON payload.