Supergateway
Run MCP stdio servers over SSE and SSE over stdio. AI gateway.
Overview
Supergateway is a tool designed to run MCP stdio-based servers over Server-Sent Events (SSE), facilitating remote access and debugging. This allows for seamless communication between MCP servers and SSE-based clients, enhancing connectivity and interoperability.
To use Supergateway, run it via npx with a command that executes an MCP server. Example command: npx -y supergateway --stdio "uvx mcp-server-git", which starts the server and opens an SSE endpoint for client connections.
- Simple installation and execution via npx - Creates an SSE endpoint for MCP stdio servers - Supports remote access and debugging - Integrates with other tools like MCP Inspector and ngrok for external connectivity
- Connecting remote clients to an MCP server that operates only through stdio.
- Debugging MCP servers using SSE protocols.
- Sharing local MCP servers over the internet using ngrok.
Add to your AI client
Use these steps to connect Supergateway in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"supergateway-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-supergateway-supercorp-ai"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"supergateway-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-supergateway-supercorp-ai"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"supergateway-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-supergateway-supercorp-ai"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"supergateway-supercorp-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-supergateway-supercorp-ai"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"supergateway-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-supergateway-supercorp-ai"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"supergateway-supercorp-ai": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-supergateway-supercorp-ai"
]
}
}
}FAQ
Can I use Supergateway with any MCP server?
Yes, as long as the server communicates over stdio, it can be run with Supergateway.
Is Supergateway suitable for production use?
Yes, it can be configured for production, but ensure proper security measures are taken when exposing endpoints externally.
How do I share my local MCP server with others?
Use ngrok in conjunction with Supergateway to create a public URL that can be accessed by remote clients.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":517,"uuid":"f954e254-762b-4da9-abf5-5d740a7364c0","name":"supergateway","title":"Supergateway","description":"Run MCP stdio servers over SSE and SSE over stdio. AI gateway.","avatar_url":"https://avatars.githubusercontent.com/u/152935339?v=4","created_at":"2024-12-30T02:52:53.788Z","updated_at":"2025-01-05T03:00:14.566Z","status":"created","author_name":"supercorp-ai","author_avatar_url":"https://avatars.githubusercontent.com/u/152935339?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/supercorp-ai/supergateway","target":"_self","content":"$29","summary":"$2a","img_url":"https://raw.githubusercontent.com/supercorp-ai/supergateway/main/supergateway.png","type":null,"metadata":"{\"star\":\"1438\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-06-01 23:19:00\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]