# Gearcoleco MCP Server

This MCP server connects Gearcoleco to AI coding agents for emulator debugging, execution control, and memory inspection.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 143
- Author: drhelius
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/drhelius/Gearcoleco
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/gearcoleco-mcp-server

## What it does

Gearcoleco MCP Server is built into the Gearcoleco ColecoVision and Coleco ADAM emulator. It exposes tools for Claude Code and Codex to control execution, inspect memory, check hardware state, and rewind. The project itself is written in C++ and includes a debugger for development work.

Gearcoleco provides a disassembler, CPU and memory-access breakpoints, address navigation, a memory editor, trace logging, and VRAM inspection. An MCPB package for all platforms is documented in `MCP_README.md`. ADAM mode requires BIOS and ADAM Firmware, which are not bundled.

The emulator runs on Windows, macOS, Linux, and BSD. The MCP server is also listed for Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed. Linux may require `libsdl3`; Windows builds may require the Visual C++ Redistributable and OpenGL Compatibility Pack.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- control emulator execution from an AI agent
- inspect memory and hardware state
- set breakpoints while debugging games
- examine VRAM, registers, tiles, and sprites
- rewind execution during diagnosis

## Example prompts
- Start Gearcoleco, inspect the hardware state, and explain the problem you find.
- Set a memory-access breakpoint and trace execution until the value changes.
- Show the current VRAM contents, registers, and sprites.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 975
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 733

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md