Supergateway

v3.4.3Developer Toolsstable

Run MCP stdio servers over SSE and SSE over stdio. AI gateway.

mcpstdiossegatewayproxy
Share:
2,639
Stars
0
Downloads
0
Weekly
0/5

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

Bridge MCP stdio and SSE protocols with an AI gateway.
Route and proxy multiple MCP server connections.
supercorp-ai

Maintainer

LicenseMIT
Languagetypescript
Versionv3.4.3
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y supergateway

Manual Installation

npx -y supergateway

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Supergateway

Supergateway is an AI gateway that bridges MCP stdio servers with SSE (Server-Sent Events) and HTTP protocols, enabling seamless protocol translation. Connect it to Claude to route multiple MCP servers through a unified gateway, eliminating direct stdio connections and simplifying multi-server orchestration.

Prerequisites

  • Node.js 18+ installed
  • An MCP client such as Claude Desktop or Cursor
  • One or more MCP stdio servers to proxy through the gateway
  • Familiarity with HTTP and SSE concepts
1

Install Supergateway

Install Supergateway globally or locally using npm.

npx -y supergateway
2

Create a gateway configuration

Set up a configuration file to define which stdio servers to proxy through the gateway.

{
  "port": 3000,
  "servers": [
    {
      "name": "my-stdio-server",
      "command": "node",
      "args": ["/path/to/server.js"]
    }
  ]
}
3

Add to Claude Desktop configuration

Configure Claude Desktop to connect to the Supergateway endpoint.

{
  "mcpServers": {
    "supergateway": {
      "command": "npx",
      "args": ["-y", "supergateway"]
    }
  }
}
4

Start the gateway

Run Supergateway to begin proxying your MCP servers over HTTP/SSE.

npx supergateway --config /path/to/config.json
5

Verify gateway is running

Check that Supergateway is listening on the configured port and proxying servers correctly.

curl http://localhost:3000/health
6

Restart Claude Desktop

Close and reopen Claude Desktop to activate the gateway connection.

Supergateway Examples

Claude Desktop Configuration

How to register Supergateway as an MCP server.

{
  "mcpServers": {
    "supergateway": {
      "command": "npx",
      "args": ["-y", "supergateway"]
    }
  }
}

Prompts to Try

Example prompts when using Supergateway.

- "Use the proxied servers to get me information about the weather."
- "Query multiple backend servers through the unified gateway."
- "Show me all available tools from the proxied MCP servers."

Troubleshooting Supergateway

Gateway fails to start or reports port already in use

Change the port in your configuration file or kill the process using the port. Use lsof -i :3000 to find the process and kill it.

Proxied servers not appearing in Claude Desktop

Verify that the gateway configuration correctly lists all stdio servers. Restart the gateway and Claude Desktop, then check the gateway's status endpoint.

Connection timeout when calling proxied servers

Ensure the stdio servers are running and accessible. Check that the command and args in the gateway config are correct and the server executables exist.

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.

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.

Quick Config Preview

{ "mcpServers": { "supergateway": { "command": "npx", "args": ["-y", "supergateway"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides