Skip to main content
Glama
dbowlin

CoCo 3 MCP Bridge

by dbowlin
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

CoCo 3 MCP Bridge

An MCP server that runs a Color Computer 3 in MAME so an AI assistant can type BASIC, mount disks, take screen snapshots, and peek/poke at memory.

  • Screenshots are at the bottom of this README.

OS Information

  • This version is for Windows 10 or newer.

  • It can be easily adapted for Linux, MacOS, BSD.

Related MCP server: C64 Debug MCP

Requirements

Public Release / Setup

This repository does not bundle MAME, CoCo 3 ROMs, or ToolShed binaries due to licensing and copyright restrictions. Users must install these dependencies locally:

  • MAME & CoCo 3 ROMs: Download MAME and supply your own legal CoCo 3 ROMs (e.g., coco3.zip). You can place mame.exe and roms/ directly in the project's mame/ directory (see mame/README.md), or point to an existing MAME installation on your system.

  • ToolShed (decb): ToolShed is required if you want to build disk images with coco_build_disk. Download or compile ToolShed and place decb.exe in the toolshed/ directory (see toolshed/README.md), or configure DECB_PATH in .env.

For CoCo ROMs, software, and documentation, visit the Color Computer Archive.

Setup

cd MCP
cp .env.example .env

Edit .env so MAME_PATH, MAME_ROMPATH, and DECB_PATH point at your local installs.

npm install
npm run build

Run

Point your MCP client at MCP/dist/index.js (working directory: the repo root, or MCP if you adjust the path). Then use the coco_start tool to launch MAME — don’t start MAME separately.

coco_start turns on real lowercase by default (runs WIDTH 40; pass trueLowercase: false to skip).

Files

MCP/storage/disks/       disk images (.dsk)
MCP/storage/host/bas/    BASIC sources on the PC
MCP/storage/host/bin/    .BIN files
MCP/storage/host/data/   other host files

Mount with a path like storage/disks/game.dsk. See MCP/storage/README.md.

Screenshots

screenshot

screenshot

screenshot

screenshot

Disclosure

Agentic AI was used in the development of this app.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • beebjit-mcp

    acscpt
    A
    license
    A
    quality
    B
    maintenance
    Lets an AI application instantiate, connect to, drive, capture output from, and interrogate a real BBC Micro emulator.
    22
    1
    MIT

  • C64 Debug MCP

    henols
    A
    license
    A
    quality
    D
    maintenance
    Enables AI-powered control and debugging of Commodore 64 programs via the VICE emulator, supporting memory operations, breakpoints, register access, and program loading.
    18
    0
    MIT

  • pet-tools-mcp

    nschneir
    A
    license
    B
    quality
    A
    maintenance
    Enables AI agents to code and debug Commodore PET software using the VICE emulator, with CLI and MCP tools for session control, screen reading, memory manipulation, and testing.
    44
    1
    MIT

  • dosbox-mcp

    dosbox-automation
    A
    license
    Not graded
    quality
    C
    maintenance
    Bridges AI agents to a DOSBox emulator, enabling control of DOS programs via MCP tools for typing, screen reading, video capture, Lua scripting, and memory access.
    2
    GPL 2.0