Service: Supergateway - EyevinnOSC/community GitHub Wiki

Supergateway

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.

What it can do

  • 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.

Creating an instance

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"

Options

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).

Using the instance

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"
    }
  }
}

Resources

⚠️ **GitHub.com Fallback** ⚠️