# C64 Bridge

> C64 Bridge is an open-source MCP server for developer tools. Run programs, read memory and play sound on a Commodore 64 or VICE from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/chrisgleissner/c64bridge
- **MCP Registry name:** io.github.chrisgleissner/c64bridge
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

C64 Bridge points an AI client at real Commodore 64 hardware or an emulator. It targets the C64 Ultimate, Ultimate 64 and U2-family cartridges, and can switch to a VICE emulator session at runtime, so one conversation can move between hardware and emulation. The tools are grouped by area rather than one per action, for example c64_program, c64_memory, c64_graphics and c64_sound.

What an agent can do includes running BASIC, 6510 assembly and PRG or CRT files, reading and writing memory including screen polling, driving disks, drives and printers, and composing, generating and verifying SID music. Built-in resources, skills and retrieval give the assistant background on classic C64 programming and on Ultimate features such as REU, CPU turbo, ten SIDs, LED control, UCI networking and full-colour border graphics.

It runs over stdio, with an optional HTTP bridge for manual inspection, needs Node.js 24 or newer, and reads backend settings from a config file or environment variables. A VS Code agent mode is documented. The README shows a GPL-2.0 licence badge.

## Features

- **Hardware and emulator:** Drives C64 Ultimate, Ultimate 64, U2-family devices and VICE, switchable at runtime.
- **Program runners:** Runs BASIC, 6510 assembly, PRG and CRT files.
- **Memory access:** Raw reads and writes plus screen polling.
- **SID music tools:** Playback, composition, generation and verification.
- **Disk, drive and printer tools:** Manages disks, files, drives and printer workflows.
- **Built-in C64 knowledge:** Resources, prompts and retrieval for safer coding help.
- **HTTP bridge:** Optional endpoint for inspecting tools by hand.

## Good for

- Have an assistant write and run a BASIC or assembly program on real hardware
- Poke and inspect memory while debugging a demo
- Render graphics or generate SID music and play it on a C64 Ultimate
- Test the same program on hardware and in VICE in one session
- Mount a disk image and list its contents

## Install

### Claude Code (Terminal)

```sh
claude mcp add c64bridge --env C64BRIDGE_HTTP_TOKEN='<C64BRIDGE_HTTP_TOKEN>' --env C64U_PASSWORD='<C64U_PASSWORD>' --env U2_PASSWORD='<U2_PASSWORD>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y c64bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "C64BRIDGE_HTTP_TOKEN": "<C64BRIDGE_HTTP_TOKEN>",
        "C64U_PASSWORD": "<C64U_PASSWORD>",
        "U2_PASSWORD": "<U2_PASSWORD>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "C64BRIDGE_HTTP_TOKEN": "<C64BRIDGE_HTTP_TOKEN>",
        "C64U_PASSWORD": "<C64U_PASSWORD>",
        "U2_PASSWORD": "<U2_PASSWORD>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "c64bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "C64BRIDGE_HTTP_TOKEN": "<C64BRIDGE_HTTP_TOKEN>",
        "C64U_PASSWORD": "<C64U_PASSWORD>",
        "U2_PASSWORD": "<U2_PASSWORD>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "C64BRIDGE_HTTP_TOKEN": "<C64BRIDGE_HTTP_TOKEN>",
        "C64U_PASSWORD": "<C64U_PASSWORD>",
        "U2_PASSWORD": "<U2_PASSWORD>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge"
      ],
      "env": {
        "C64BRIDGE_HTTP_TOKEN": "<C64BRIDGE_HTTP_TOKEN>",
        "C64U_PASSWORD": "<C64U_PASSWORD>",
        "U2_PASSWORD": "<U2_PASSWORD>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

## Tools

- `c64_batch`: Grouped C64 Bridge tool: batch.
- `c64_config`: Grouped C64 Bridge tool: config.
- `c64_debug`: Grouped C64 Bridge tool: debug.
- `c64_disk`: Grouped C64 Bridge tool: disk.
- `c64_drive`: Grouped C64 Bridge tool: drive.
- `c64_extract`: Grouped C64 Bridge tool: extract.
- `c64_graphics`: Grouped C64 Bridge tool: graphics.
- `c64_input`: Grouped C64 Bridge tool: input.
- `c64_memory`: Grouped C64 Bridge tool: memory.
- `c64_printer`: Grouped C64 Bridge tool: printer.
- `c64_program`: Grouped C64 Bridge tool: program.
- `c64_rag`: Grouped C64 Bridge tool: rag.
- `c64_select_backend`: Grouped C64 Bridge tool: select backend.
- `c64_sound`: Grouped C64 Bridge tool: sound.
- `c64_stream`: Grouped C64 Bridge tool: stream.
- `c64_system`: Grouped C64 Bridge tool: system.
- `c64_vice`: Grouped C64 Bridge tool: vice.

## FAQ

### Which machines does it support?

C64 Ultimate and Ultimate 64 (c64u), U2, U2+ and U2+L cartridges (u2), and the VICE emulator.

### What do I need to run it?

Node.js 24 or newer; start it with npx -y c64bridge@latest and add a backend configuration.

### Can I switch between hardware and VICE?

Yes, c64_select_backend switches at runtime when both are configured.

### What licence is it under?

The README shows a GPL-2.0 badge.

### Which transport does it use?

stdio, with an optional HTTP bridge for manual inspection.

### Is C64 Bridge free?

Yes. C64 Bridge is open source, so you can use and self-host it for free.

### How do I add C64 Bridge to Claude Code?

Run this command in your terminal: claude mcp add c64bridge --env C64BRIDGE_HTTP_TOKEN='<C64BRIDGE_HTTP_TOKEN>' --env C64U_PASSWORD='<C64U_PASSWORD>' --env U2_PASSWORD='<U2_PASSWORD>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y c64bridge

### What are the best alternatives to C64 Bridge?

The closest alternatives to C64 Bridge are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/c64-bridge
