Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 1.91 KB

README.md

File metadata and controls

58 lines (39 loc) · 1.91 KB

Supergateway: Run stdio MCP servers over SSE

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

Supported by superinterface.ai and supercorp.ai.

Installation & Usage

Run Supergateway via npx:

npx -y supergateway --stdio "uvx mcp-server-git"
  • --port 8000: Port to listen on (default: 8000)
  • --stdio: Command that runs an MCP server over stdio

Once started:

  • SSE endpoint: GET http://localhost:8000/sse
  • POST messages: POST http://localhost:8000/message

Example with MCP Inspector

  1. Run Supergateway:
    npx -y supergateway --port 8000 \
        --stdio "npx -y @modelcontextprotocol/server-filesystem /Users/MyName/Desktop"
  2. Use MCP Inspector:
    npx @modelcontextprotocol/inspector --uri http://localhost:8000/sse
    You can then read resources, list tools, or run other MCP actions through Supergateway.

Using with ngrok

You can use ngrok to share your local MCP server with remote clients:

npx -y supergateway --port 8000 \
    --stdio "npx -y @modelcontextprotocol/server-filesystem ."
# In another terminal:
ngrok http 8000

ngrok then provides a public URL.

Why MCP?

Model Context Protocol standardizes how AI tools exchange data. If your MCP server only speaks stdio, Supergateway exposes an SSE-based interface so remote clients (and tools like MCP Inspector) can connect without extra server changes.

Contributing

Issues and PRs are welcome. Please open one if you have ideas or encounter any problems.

License

MIT License