@undisk-mcp/stdio-proxy

@undisk-mcp/stdio-proxy

Bridges local stdio MCP clients (like Claude Desktop) to the remote Undisk MCP edge server over Streamable HTTP.

Usage

npx -y @undisk-mcp/stdio-proxy

Or install globally:

npm install -g @undisk-mcp/stdio-proxy
undisk-proxy

Environment Variables

• UNDISK_API_KEY — your Undisk MCP API key (required)
• UNDISK_ENDPOINT — server endpoint (default: https://mcp.undisk.app)

Workspace Routing

To target a specific workspace, set UNDISK_ENDPOINT with a ?workspace= query parameter. Quote the URL to prevent your shell from interpreting the ?:

UNDISK_API_KEY=sk_live_xxx \
  UNDISK_ENDPOINT='https://mcp.undisk.app?workspace=YOUR_WORKSPACE_ID' \
  npx -y @undisk-mcp/stdio-proxy

OpenAI Codex

# Default workspace
codex mcp add undisk \
  --env UNDISK_API_KEY=sk_live_xxx \
  -- npx -y @undisk-mcp/stdio-proxy

# Specific workspace (quote the URL to avoid zsh glob errors)
codex mcp add undisk-myproject \
  --env UNDISK_API_KEY=sk_live_xxx \
  --env 'UNDISK_ENDPOINT=https://mcp.undisk.app?workspace=YOUR_WORKSPACE_ID' \
  -- npx -y @undisk-mcp/stdio-proxy

Claude Desktop

npx -y @undisk-mcp/setup-claude --api-key sk_live_xxx

Claude Code

claude mcp add --transport http undisk \
  'https://mcp.undisk.app/v1/mcp?workspace=YOUR_WORKSPACE_ID' \
  --header "Authorization: Bearer sk_live_xxx"

How It Works

The proxy reads JSON-RPC messages from stdin, forwards them to the Undisk MCP server via Streamable HTTP, and writes responses to stdout. This enables tools that only support local stdio transports (e.g., Claude Desktop) to connect to the remote Undisk MCP workspace.

License

MIT