# Supergateway — Bridge MCP Servers via SSE and HTTP

> Run any MCP stdio server over SSE or HTTP transport. Supergateway bridges local MCP servers for remote access, enabling cloud deployment and multi-client sharing.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
npx -y supergateway --stdio "npx -y @modelcontextprotocol/server-filesystem ."
```

MCP server now accessible at `http://localhost:8000/sse`.

## What is Supergateway?

Supergateway converts any MCP server that uses stdio transport into an SSE (Server-Sent Events) or HTTP server. This enables remote access to local MCP servers, cloud deployment, and sharing a single MCP server across multiple AI clients.

**Answer-Ready**: Supergateway bridges MCP stdio servers to SSE/HTTP transport, enabling remote access, cloud deployment, and multi-client sharing of any MCP server. One command to expose local MCP servers over the network.

**Best for**: Teams deploying MCP servers to the cloud or sharing them across multiple AI clients. **Works with**: Any MCP stdio server, Claude Code, Cline, Cursor. **Setup time**: Under 1 minute.

## Core Features

### 1. Stdio to SSE Bridge

```bash
# Expose filesystem MCP server via SSE
npx -y supergateway \
  --stdio "npx -y @modelcontextprotocol/server-filesystem /data" \
  --port 8000

# Connect from Claude Code (remote)
# .mcp.json
{
  "mcpServers": {
    "remote-fs": {
      "type": "sse",
      "url": "http://server-ip:8000/sse"
    }
  }
}
```

### 2. Stdio to HTTP (Streamable HTTP)

```bash
npx -y supergateway \
  --stdio "npx -y @modelcontextprotocol/server-github" \
  --transport httpStream \
  --port 8000
```

### 3. SSE to Stdio (Reverse Bridge)

```bash
# Convert a remote SSE server back to stdio for local tools
npx -y supergateway \
  --sse "http://remote-server:8000/sse" \
  --outputTransport stdio
```

### 4. Multiple Transports

| Mode | Command | Use Case |
|------|---------|----------|
| stdio → SSE | `--stdio "cmd" --transport sse` | Remote access |
| stdio → HTTP | `--stdio "cmd" --transport httpStream` | REST-style access |
| SSE → stdio | `--sse "url" --outputTransport stdio` | Local consumption |

### 5. Docker Deployment

```dockerfile
FROM node:20-slim
RUN npm install -g supergateway @modelcontextprotocol/server-github
CMD ["supergateway", "--stdio", "mcp-server-github", "--port", "8000"]
EXPOSE 8000
```

```bash
docker build -t mcp-github .
docker run -p 8000:8000 -e GITHUB_TOKEN=ghp_... mcp-github
```

## Use Cases

| Scenario | How |
|----------|-----|
| Cloud MCP | Deploy MCP servers as cloud services |
| Team sharing | One MCP server, multiple developers |
| Remote dev | Access home MCP servers from anywhere |
| Kubernetes | MCP servers as microservices |

## Architecture

```
Local MCP Server (stdio)
    ↓
Supergateway (bridge)
    ↓
SSE/HTTP endpoint
    ↓
Claude Code / Cline / Cursor (remote clients)
```

## FAQ

**Q: Is it secure?**
A: Supergateway itself doesn't add authentication. Use a reverse proxy (nginx, Caddy) with auth for production.

**Q: Does it support all MCP features?**
A: Yes, full MCP protocol support including tools, resources, and prompts.

**Q: Performance overhead?**
A: Minimal — just transport translation. No processing of MCP payloads.

## Source & Thanks

> Created by [Supercorp](https://github.com/supercorp-ai). Licensed under MIT.
>
> [supercorp-ai/supergateway](https://github.com/supercorp-ai/supergateway) — 1k+ stars

<!-- ZH -->


## Quick Start

```bash
npx -y supergateway --stdio "npx -y @modelcontextprotocol/server-filesystem ."
```

One command exposes a local MCP server as an SSE endpoint.

## What is Supergateway?

Supergateway converts MCP servers using stdio transport into SSE/HTTP servers, enabling remote access, cloud deployment, and multi-client sharing.

**In one sentence**: Supergateway bridges MCP stdio servers to SSE/HTTP transports, enabling remote access and cloud deployment.

**For**: Developers who need to deploy MCP servers to the cloud or share them across teams.

## Core Features

### 1. stdio → SSE Bridging
Turn local MCP servers into network-accessible endpoints.

### 2. Reverse Bridging
Convert remote SSE servers back to stdio for local tools.

### 3. Docker Deployment
Containerize MCP servers and run as Kubernetes microservices.

## FAQ

**Q: Is it secure?**
A: Supergateway doesn't include authentication — use a reverse proxy with auth in production.

**Q: Performance overhead?**
A: Minimal — just transport translation.

## Source & Thanks

> [supercorp-ai/supergateway](https://github.com/supercorp-ai/supergateway) — MIT

---
Source: https://tokrepo.com/en/workflows/supergateway-bridge-mcp-servers-via-sse-http-99cc4769
Author: MCP Hub