Supergateway
Run MCP stdio servers over SSE and SSE over stdio. AI gateway.
What is Supergateway?
Supergateway is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to run mcp stdio servers over sse and sse over stdio. ai gateway.
Run MCP stdio servers over SSE and SSE over stdio. AI gateway.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Run MCP stdio servers over SSE and SSE over stdio. AI gatewa
Use Cases
Maintainer
Works with
Installation
NPM
npx -y supergatewayManual Installation
npx -y supergatewayConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Supergateway
Supergateway is a zero-dependency bridge that converts MCP stdio servers into SSE (Server-Sent Events), WebSocket, or Streamable HTTP endpoints — and vice versa — with a single npx command. It lets you expose any local stdio MCP server over the network for remote access, share it publicly via ngrok, connect to remote SSE or Streamable HTTP MCP servers from clients that only speak stdio, and run everything in Docker. Developers and platform teams use it when they need to integrate MCP servers across different transport protocols without modifying the servers themselves.
Prerequisites
- Node.js 18+ installed (for npx usage)
- Docker if using the containerised image
- The stdio MCP server you want to expose (e.g. npx -y @modelcontextprotocol/server-filesystem)
- An MCP-compatible client such as Claude Desktop or Cursor
- ngrok (optional) if you want to expose the server publicly
Expose a stdio MCP server over SSE
Run Supergateway to wrap an existing stdio MCP server and serve it as an SSE endpoint on port 8000. Subscribe to GET /sse and send messages to POST /message.
npx -y supergateway \
--stdio "npx -y @modelcontextprotocol/server-filesystem ./my-folder" \
--port 8000 --baseUrl http://localhost:8000 \
--ssePath /sse --messagePath /messageConnect to a remote SSE server via stdio
Use Supergateway in reverse to consume a remote SSE MCP server and expose it locally over stdio, which is what Claude Desktop expects.
npx -y supergateway --sse "https://your-mcp-server.example.com/sse"Connect to a Streamable HTTP server via stdio
Bridge a newer Streamable HTTP MCP server down to a local stdio interface.
npx -y supergateway --streamableHttp "https://your-mcp-server.example.com/mcp"Add authentication headers
Pass authentication headers when connecting to protected remote SSE or Streamable HTTP servers using --oauth2Bearer or --header.
npx -y supergateway \
--sse "https://your-mcp-server.example.com/sse" \
--oauth2Bearer "your-access-token" \
--header "X-Custom-Header: value"Run via Docker for a portable setup
Use the official Docker image to avoid local Node.js setup and run Supergateway in an isolated container.
docker run -it --rm -p 8000:8000 supercorp/supergateway \
--stdio "npx -y @modelcontextprotocol/server-filesystem /" \
--port 8000Expose publicly via ngrok
Combine Supergateway with ngrok to share a local MCP server over the internet.
# Terminal 1
npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem ."
# Terminal 2
ngrok http 8000Supergateway Examples
Client configuration — SSE to stdio (Claude Desktop)
Configure Claude Desktop to consume a remote SSE MCP server through Supergateway acting as a stdio bridge.
{
"mcpServers": {
"supergateway-remote": {
"command": "npx",
"args": [
"-y",
"supergateway",
"--sse",
"https://your-mcp-server.example.com/sse"
]
}
}
}Prompts to try
Example prompts once a file-system MCP server is exposed via Supergateway and connected to Claude.
- "List all TypeScript files in my project folder."
- "Read the contents of src/index.ts and suggest improvements."
- "Create a new file called CHANGELOG.md with a version 1.0.0 entry for today."
- "Search for all TODO comments in the codebase and summarise them."Troubleshooting Supergateway
SSE client connects but receives no events
Confirm the stdio MCP server process starts correctly by running its command directly in a terminal (e.g. npx -y @modelcontextprotocol/server-filesystem ./folder) before wrapping it with Supergateway. If the underlying server exits immediately, Supergateway will close the SSE connection. Use --logLevel debug to see the server's stdout/stderr.
Authorization header with a space is dropped in Cursor
There is a known Cursor bug where command-line arguments containing spaces are truncated. Always use --oauth2Bearer your-token instead of --header "Authorization: Bearer your-token" when connecting to Cursor. The --oauth2Bearer flag is specifically designed to work around this limitation.
CORS errors when a browser client tries to connect to the SSE endpoint
Add the --cors flag when starting Supergateway in stdio→SSE mode. To allow all origins use --cors with no value; to restrict to specific origins use --cors "https://your-frontend.com". Regex patterns are also supported: --cors "/your-domain\\.com$/".
Frequently Asked Questions about Supergateway
What is Supergateway?
Supergateway is a Model Context Protocol (MCP) server that run mcp stdio servers over sse and sse over stdio. ai gateway. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Supergateway?
Install via npm with the command: npx -y supergateway. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Supergateway?
Supergateway works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Supergateway free to use?
Yes, Supergateway is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Supergateway Alternatives — Similar Developer Tools Servers
Looking for alternatives to Supergateway? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Supergateway in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Supergateway?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.