Service: Supergateway - EyevinnOSC/community GitHub Wiki
Supergateway (serviceId supercorp-ai-supergateway) is an open source gateway that runs stdio-based MCP (Model Context Protocol) servers over SSE (Server-Sent Events) or WebSockets. It exposes any MCP server, including command-line tools, as a network-accessible endpoint that AI agents and MCP clients can connect to remotely. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. License: MIT.
- Wrap a stdio MCP server and make it available over HTTP as an SSE endpoint.
- Give a private or local-only MCP server a stable public HTTPS endpoint without managing your own infrastructure.
- Let remote AI agents and MCP clients (Claude Desktop, Continue, any SSE-compatible client) use the wrapped server.
Supergateway has no dependencies on other OSC services. The McpServer option takes the full shell command that launches the stdio MCP server process. Common examples:
| MCP server | McpServer value |
|---|---|
| Filesystem server | npx -y @modelcontextprotocol/server-filesystem /tmp |
| Fetch server | npx -y @modelcontextprotocol/server-fetch |
| Custom server | node /app/my-mcp-server.js |
Create the instance with create-service-instance using serviceId: "supercorp-ai-supergateway". The instance name must be alphanumeric and at most 20 characters.
{
"name": "mygateway",
"McpServer": "npx -y @modelcontextprotocol/server-fetch"
}With environment variables for the wrapped server:
{
"name": "mygateway",
"McpServer": "node /app/server.js",
"EnvVars": "API_KEY=<value> DEBUG=true"
}Wait with wait-for-service-ready or get-instance-status, then read the URL with describe-service-instance.
OSC CLI example:
osc create supercorp-ai-supergateway mygateway \
-o McpServer="npx -y @modelcontextprotocol/server-fetch"| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the instance. Letters, digits and underscore only; on OSC at most 20 characters. |
| McpServer | Yes | string | The full shell command used to launch the stdio MCP server to expose, for example npx -y @modelcontextprotocol/server-fetch. |
| EnvVars | No | string | Environment variables to inject for the MCP server process, as KEY=value pairs separated by spaces, for example API_KEY=<value> DEBUG=true. The catalog does not mark it sensitive; if it contains credentials, store the whole string as a service secret and pass it as {{secrets.NAME}} (a secret reference must be the entire field value). |
The instance exposes an SSE endpoint at:
https://<instance-url>/sse
Configure your MCP client to connect to this URL. Claude Desktop example (claude_desktop_config.json):
{
"mcpServers": {
"my-supergateway": {
"url": "https://<instance-url>/sse"
}
}
}