# supercorp-ai/supergateway

> supergateway is a command-line tool that runs MCP stdio-based servers over SSE, WebSockets or Streamable HTTP with one command. It is meant for remote access, debugging, or connecting clients when an MCP server only supports stdio. It wraps a stdio server command and serves it over the chosen transport, and it can also serve a remote SSE or Streamable HTTP server over stdio. The project is written mainly in TypeScript.

Source: https://github.com/supercorp-ai/supergateway
Indexed: commit 5ad19d3 on 2026-11-10 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: TypeScript
- Stars: 2,965 at index time
- License: MIT
- Code health: 8.8/10, Excellent
- Last commit: 2026-11-10
- Contributors: 9

## Install

From the README: https://github.com/supercorp-ai/supergateway#installation--usage

Run supergateway with npx, starting an MCP server that speaks stdio, in this case the git server from uvx.
    npx -y supergateway --stdio "uvx mcp-server-git"

Start MCP Inspector in a second terminal to connect to the gateway and list tools, resources and other MCP actions.
    npx @modelcontextprotocol/inspector

## How it works

The package has two entry points, src/cli.ts and src/index.ts, and the command-line flags select which mode runs. The src/gateways directory holds one module per conversion, including stdioToStatefulStreamableHttp.ts, stdioToStatelessStreamableHttp.ts and streamableHttpToStdio.ts, so a stdio server is exposed over Streamable HTTP in stateful or stateless form, or a remote Streamable HTTP server is turned into stdio. src/lib/modernHttp.ts is listed among the central hotspot files of the code. The tests directory holds most of the repository's files and covers the clients and the gateway behavior, and the scripts directory holds supporting scripts. Client requests come in over the selected transport, pass through the matching gateway module, and the server's responses go back out to the client.

- src/cli.ts: entry point
- src/index.ts: entry point
- .github/ISSUE_TEMPLATE/bug_report.yml: central file
- .github/ISSUE_TEMPLATE/config.yml: central file
- .github/ISSUE_TEMPLATE/feature_request.yml: central file
Modules: tests, src, scripts, root. 450 files, 57,767 lines, 1,896 symbols.

## Code health

- Score: 8.8/10 (Excellent)
- Rank: #23 of 4,000+ indexed repos
- Hotspots: src/index.ts, src/lib/modernHttp.ts, src/gateways/stdioToStatefulStreamableHttp.ts, src/gateways/stdioToStatelessStreamableHttp.ts, src/gateways/streamableHttpToStdio.ts
- Lowest file: src/lib/ownedChildProcesses.ts
- Dead code: none found

## Maintenance

- Last commit 2026-11-10, first commit 2024-12-21, 658 commits
- 9 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/supercorp-ai/supergateway/security

## More

- Page: https://repowise.dev/repo/supercorp-ai/supergateway
- Ask this codebase: https://repowise.dev/repo/supercorp-ai/supergateway/chat
- Docs: https://repowise.dev/repo/supercorp-ai/supergateway/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/supercorp-ai/supergateway
