# 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 -->

## 快速使用

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

一行命令将本地 MCP 服务器暴露为 SSE 端点。

## 什么是 Supergateway？

Supergateway 将 stdio 传输的 MCP 服务器转换为 SSE/HTTP 服务器，实现远程访问、云部署和多客户端共享。

**一句话总结**：Supergateway 桥接 MCP stdio 服务器到 SSE/HTTP 传输，实现远程访问和云部署。

**适合人群**：需要云部署或团队共享 MCP 服务器的开发者。

## 核心功能

### 1. stdio → SSE 桥接
本地 MCP 服务器变为网络可访问端点。

### 2. 反向桥接
远程 SSE 服务器转回 stdio 供本地工具使用。

### 3. Docker 部署
容器化 MCP 服务器，Kubernetes 微服务化。

## 常见问题

**Q: 安全吗？**
A: Supergateway 不含认证，生产环境用反向代理加认证。

**Q: 性能开销？**
A: 极小，仅传输转换。

## 来源与致谢

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

---
Source: https://tokrepo.com/en/workflows/99cc4769-5171-410a-9541-c9cd9c31406a
Author: MCP Hub