C64 Bridge MCP Server

Name: C64 Bridge MCP Server
Author: io.github.chrisgleissner

io.github.chrisgleissner/c64bridge

Repository Registry

What is the C64 Bridge MCP server?

MCP server for Commodore 64 Ultimate hardware and VICE emulator control.

How to install C64 Bridge

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

LOG_LEVEL
Logger verbosity.
C64BRIDGE_CONFIG
Path to the C64 Bridge configuration file.
C64_MODE
Active backend.
C64U_HOST
Ultimate 64 host name or IP address.
C64U_PORT
Ultimate 64 REST port.
C64U_PASSWORD
secret
Ultimate 64 network password sent as X-Password.
VICE_BINARY
VICE emulator binary to launch.
VICE_VISIBLE
Launch VICE with a visible window when possible.
VICE_WARP
Enable VICE warp mode.
GITHUB_TOKEN
secret
GitHub token for optional RAG discovery against GitHub.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "C64BRIDGE_CONFIG": "<YOUR_C64BRIDGE_CONFIG>",
        "C64_MODE": "<YOUR_C64_MODE>",
        "C64U_HOST": "<YOUR_C64U_HOST>",
        "C64U_PORT": "<YOUR_C64U_PORT>",
        "C64U_PASSWORD": "<YOUR_C64U_PASSWORD>",
        "VICE_BINARY": "<YOUR_VICE_BINARY>",
        "VICE_VISIBLE": "<YOUR_VICE_VISIBLE>",
        "VICE_WARP": "<YOUR_VICE_WARP>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "C64BRIDGE_CONFIG": "<YOUR_C64BRIDGE_CONFIG>",
        "C64_MODE": "<YOUR_C64_MODE>",
        "C64U_HOST": "<YOUR_C64U_HOST>",
        "C64U_PORT": "<YOUR_C64U_PORT>",
        "C64U_PASSWORD": "<YOUR_C64U_PASSWORD>",
        "VICE_BINARY": "<YOUR_VICE_BINARY>",
        "VICE_VISIBLE": "<YOUR_VICE_VISIBLE>",
        "VICE_WARP": "<YOUR_VICE_WARP>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "C64BRIDGE_CONFIG": "<YOUR_C64BRIDGE_CONFIG>",
        "C64_MODE": "<YOUR_C64_MODE>",
        "C64U_HOST": "<YOUR_C64U_HOST>",
        "C64U_PORT": "<YOUR_C64U_PORT>",
        "C64U_PASSWORD": "<YOUR_C64U_PASSWORD>",
        "VICE_BINARY": "<YOUR_VICE_BINARY>",
        "VICE_VISIBLE": "<YOUR_VICE_VISIBLE>",
        "VICE_WARP": "<YOUR_VICE_WARP>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "c64bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "C64BRIDGE_CONFIG": "<YOUR_C64BRIDGE_CONFIG>",
        "C64_MODE": "<YOUR_C64_MODE>",
        "C64U_HOST": "<YOUR_C64U_HOST>",
        "C64U_PORT": "<YOUR_C64U_PORT>",
        "C64U_PASSWORD": "<YOUR_C64U_PASSWORD>",
        "VICE_BINARY": "<YOUR_VICE_BINARY>",
        "VICE_VISIBLE": "<YOUR_VICE_VISIBLE>",
        "VICE_WARP": "<YOUR_VICE_WARP>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}

Claude Code

claude mcp add c64bridge --env LOG_LEVEL=<YOUR_LOG_LEVEL> --env C64BRIDGE_CONFIG=<YOUR_C64BRIDGE_CONFIG> --env C64_MODE=<YOUR_C64_MODE> --env C64U_HOST=<YOUR_C64U_HOST> --env C64U_PORT=<YOUR_C64U_PORT> --env C64U_PASSWORD=<YOUR_C64U_PASSWORD> --env VICE_BINARY=<YOUR_VICE_BINARY> --env VICE_VISIBLE=<YOUR_VICE_VISIBLE> --env VICE_WARP=<YOUR_VICE_WARP> --env GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> -- npx -y c64bridge