Gearcoleco MCP Server
ColecoVision and Coleco ADAM emulator with an embedded MCP server for AI debugging
- Pricing
- Open source
- Platforms
- Windows, macOS, Linux
- Runs
- Locally
- Version
- 1.8.0
- Listing updated
- today
Similar MCP servers
About Gearcoleco MCP Server
Gearcoleco MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Gearcoleco emulates the ColecoVision console and the Coleco ADAM computer in C++, and its MCP server lets an AI client such as Claude Code or Codex drive the emulator. The README says the tools cover execution control, memory inspection, hardware status and rewind, though it does not list individual tool names.
Emulation includes the Z80, TMS9918A video chip, SN76489 sound chip and AY-3-8910 for the Super Game Module, plus MegaCart ROMs and optional F18A v1.9. For the ADAM it supports cartridge and computer boot modes, keyboard, ADAMnet, printer, Digital Data Pack and floppy images, and a per-game keyboard mapper. Super Action Controller, Wheel and Roller controllers with mouse-driven spinners are supported.
The built-in debugger has a disassembler, breakpoints, memory editor, trace logger and a VRAM viewer for registers, tiles, sprites and backgrounds. Firmware is not included: you supply the ColecoVision BIOS, and for the ADAM the EOS and SmartWriter ROMs. It runs on Windows, macOS, Linux, BSD and RetroArch, and the registry offers per-platform MCPB bundles.
Install
Run in a terminal
claude mcp add gearcoleco -- npx -y https://github.com/drhelius/gearcoleco/releases/download/1.8.0/Gearcoleco-1.8.0-mcpb-macos-arm64.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"gearcoleco": {
"command": "npx",
"args": [
"-y",
"https://github.com/drhelius/gearcoleco/releases/download/1.8.0/Gearcoleco-1.8.0-mcpb-macos-arm64.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gearcoleco": {
"command": "npx",
"args": [
"-y",
"https://github.com/drhelius/gearcoleco/releases/download/1.8.0/Gearcoleco-1.8.0-mcpb-macos-arm64.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gearcoleco": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/drhelius/gearcoleco/releases/download/1.8.0/Gearcoleco-1.8.0-mcpb-macos-arm64.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gearcoleco": {
"command": "npx",
"args": [
"-y",
"https://github.com/drhelius/gearcoleco/releases/download/1.8.0/Gearcoleco-1.8.0-mcpb-macos-arm64.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gearcoleco": {
"command": "npx",
"args": [
"-y",
"https://github.com/drhelius/gearcoleco/releases/download/1.8.0/Gearcoleco-1.8.0-mcpb-macos-arm64.mcpb"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Embedded MCP server
- Lets AI clients control execution and inspect memory and hardware state.
- ColecoVision and ADAM
- Emulates both the console and the ADAM computer with disk and data pack support.
- Accurate hardware
- Models the Z80, TMS9918A, SN76489 and AY-3-8910 chips.
- Debugger
- Disassembler, breakpoints, trace logger, memory editor and VRAM viewer.
- Controller support
- Handles Super Action, Wheel and Roller controllers with spinners.
- Save states and rewind
- Includes previews, rewind and run-ahead.
Good for
- Debug ColecoVision homebrew with an AI assistant
- Inspect VRAM tiles and sprites while a game runs
- Run ADAM software from disk and data pack images
- Play ColecoVision cartridges with shaders and rewind
- Trace Z80 execution to find a bug
Pricing
Open source
Free and open source; sponsorship optional
Gearcoleco MCP Server FAQ
Is a BIOS included?
No. You select your own ColecoVision BIOS, and the ADAM needs EOS and SmartWriter ROMs as well.
Which platforms does it run on?
Windows, macOS, Linux, BSD and RetroArch.
What ADAM media formats work?
256 KiB .ddp, 160/320 KiB .dsk, ZIP archives of one image, and .m3u playlists.
How is it licensed or funded?
It is an open-source project supported by sponsors.
Is Gearcoleco MCP Server free?
Yes. Gearcoleco MCP Server is open source, so you can use and self-host it for free.
How do I add Gearcoleco MCP Server to Claude Code?
Run this command in your terminal: claude mcp add gearcoleco -- npx -y https://github.com/drhelius/gearcoleco/releases/download/1.8.0/Gearcoleco-1.8.0-mcpb-macos-arm64.mcpb
What are the best alternatives to Gearcoleco MCP Server?
The closest alternatives to Gearcoleco MCP Server 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.


