Getting Started

Supergateway is an open source gateway that runs stdio-based MCP (Model Context Protocol) servers over SSE (Server-Sent Events) or WebSockets. It lets you expose any MCP server — including command-line tools — as a network-accessible endpoint that AI agents and MCP clients can connect to remotely. Available as an open web service in Eyevinn Open Source Cloud.

Prerequisites

  • An Eyevinn OSC account
  • An MCP server command to expose (e.g. npx @modelcontextprotocol/server-filesystem /data)

Step 1: Identify the MCP server command

Supergateway wraps a stdio MCP server and makes it available over HTTP. The McpServer field takes the full shell command used to launch the 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

Step 2: Create the Supergateway instance

Navigate to the Supergateway service page and click Create supergateway. Fill in:

Field Description
Name Alphanumeric name for the instance
McpServer The shell command to launch your stdio MCP server
EnvVars (Optional) Environment variables to inject, as KEY=value pairs separated by spaces

Click Create and wait for the instance to start.

Step 3: Connect an MCP client

Once running, the instance exposes an SSE endpoint at:

https://<instance-url>/sse

Configure your MCP client (Claude Desktop, Continue, or any SSE-compatible client) to connect to this URL.

Claude Desktop example (claude_desktop_config.json):

{
  "mcpServers": {
    "my-supergateway": {
      "url": "https://<instance-url>/sse"
    }
  }
}

Use case: exposing a private MCP server publicly

If you have an MCP server that only runs locally, Supergateway on OSC gives it a stable public HTTPS endpoint without managing your own infrastructure. Any AI agent that supports SSE-based MCP connections can then reach it over the internet.

CLI usage

osc create supercorp-ai-supergateway mygateway \
  -o McpServer="npx -y @modelcontextprotocol/server-fetch"

With environment variables:

osc create supercorp-ai-supergateway mygateway \
  -o McpServer="node /app/server.js" \
  -o EnvVars="API_KEY=abc123 DEBUG=true"

Resources