superbox pull

Configure AI client to use an MCP server from the registry

Usage

superbox pull --name NAME --client CLIENT

Description

Pull an MCP server from the R2 registry and configure it for your AI client. The config format differs by client:

• VS Code: native HTTP transport (type: http) - no proxy needed
• All other clients: stdio bridge via npx mcp-remote

Options

--name · string · required

MCP server name to pull from registry

--client · string · required

Target AI client: vscode, cursor, windsurf, claude, or chatgpt

Supported Clients

VS Code

Configures VS Code MCP settings

Cursor

Configures Cursor MCP settings

Windsurf

Configures Windsurf MCP settings

Claude

Configures Claude Desktop MCP

ChatGPT

Configures ChatGPT MCP settings

How It Works

1. Fetch from R2

   Retrieves server metadata from R2 registry (entrypoint, lang, repo URL)

2. Generate Config

   Creates client-specific MCP configuration with the Worker HTTP URL

3. Write config entry

   • VS Code: writes { "type": "http", "url": "..."} under the "servers" key in .vscode/mcp.json
   • Other clients: writes { "type": "stdio", "command": "npx", "args": ["-y", "mcp-remote", url] } under the "mcpServers" key in the client’s config file
4. Save Config

   Writes configuration to the client’s config file location

Architecture

Examples

Cursor

superbox pull --name weather-mcp --client cursor

Example Output

$ superbox pull --name my-mcp --client cursor
Fetching server 'my-mcp' from R2 registry...
Success!
Server 'my-mcp' added to Cursor MCP config
Location: ~/.cursor/mcp.json

Configuration Format

The generated configuration depends on your client.

VS Code

Written to .vscode/mcp.json under the "servers" key:

{
"servers": {
 "my-mcp": {
"type": "http",
"url": "https://superbox-executor.<your-subdomain>.workers.dev/mcp?name=my-mcp"
 }
}
}

VS Code supports the HTTP transport natively - no proxy process required.

Cursor / Windsurf / Claude / ChatGPT

Written to the client’s config file under the "mcpServers" key:

{
"mcpServers": {
 "my-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-remote", "https://superbox-executor.<your-subdomain>.workers.dev/mcp?name=my-mcp"]
 }
}
}

mcp-remote is an npm shim that bridges stdio (required by these clients) to the HTTP Worker endpoint. It is installed automatically by npx on first use.

Platform Support

Client	Config Location
VS Code	~/Library/Application Support/Code/User/mcp.json (macOS) %APPDATA%/Code/User/mcp.json (Windows) ~/.config/Code/User/mcp.json (Linux)
Cursor	~/.cursor/mcp.json (macOS/Linux) %USERPROFILE%/.cursor/mcp.json (Windows)
Windsurf	~/Library/Application Support/Windsurf/User/mcp.json (macOS) %APPDATA%/Windsurf/User/mcp.json (Windows) ~/.config/Windsurf/User/mcp.json (Linux)
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS) %APPDATA%/Claude/claude_desktop_config.json (Windows) ~/.config/Claude/claude_desktop_config.json (Linux)

Next Steps

Inspect Server

View server details

Test Mode

Test without registry