Was ist Gearboy?
Gearboy ist ein quelloffener Emulator für Game Boy, Game Boy Color und Super Game Boy vom Entwickler drhelius, geschrieben in C++, dessen Repository aus dem Jahr 2012 stammt. Seit Version 3.8.0 vom März 2026, die auch den Debugger neu aufbaute, steckt ein MCP-Server im Emulator selbst. Ein Agent wie Claude Code oder Codex kann damit ein Spiel anhalten, SM83-Befehle einzeln ausführen, Speicher lesen und schreiben, Breakpoints setzen, LCD- und Audio-Hardware prüfen, Screenshots aufnehmen und den Controller bedienen, während die Debugger-Oberfläche denselben Zustand zeigt.
Das Repository hat rund 1.220 Sterne, steht unter GPL-3.0 und veröffentlichte 3.8.21 am 15. November 2026, mit Commits in derselben Woche. Desktop-Builds gibt es für Windows, macOS, Linux und BSD; MCP Bundles (.mcpb) für sechs Kombinationen aus Plattform und Architektur liegen in der MCP Registry, und zwei Agent Skills decken Debugging und ROM-Hacking ab.
Gearboy installieren
claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdioLohnt sich Gearboy?
Der MCP-Server ist die Schnittstelle zu einem echten Debugger, keine dünne Hülle. Das MCP-README listet 76 Tools in 12 Gruppen: Ausführungssteuerung bis hinunter zu einzelnen Befehlen und Frames, CPU-Register, Lesen und Schreiben in ROM-Bänken, VRAM, WRAM, OAM und IO, Speichersuche nach Art eines Cheat-Finders, Disassembly mit Symbolen und Lesezeichen, Call Stack, Trace-Logger, ein Profiler pro Funktion mit Zykluszahlen, Sprünge im Rückspulpuffer, Savestates, Cheats und Controller-Makros. Symboldateien aus RGBDS, GBDK-2020, WLA-DX und anderen Toolchains werden neben der ROM automatisch geladen, und erst das macht die Disassembly für ein Modell lesbar.
Eine so lange Liste kostet in jeder Sitzung Kontext, und das Flag --mcp-router geht das an: 12 häufig genutzte Tools bleiben direkt verfügbar, der Rest wird über fünf Discovery-Tools wie search_tools und get_tool_info gefunden. Standardmäßig ist alles direkt freigegeben, weil Clients wie Claude Code Tool-Schemas ohnehin erst bei Bedarf laden.
Beim Netzwerk sind die Voreinstellungen vorsichtig. Stdio ist der empfohlene Transport und öffnet keinen Port. Der HTTP-Modus, gestartet mit --mcp-http oder über das MCP-Menü, lauscht auf 127.0.0.1:7777/mcp; dort läuft er auch ohne Token, aber jede Wildcard- oder Nicht-Loopback-Adresse verlangt GEARBOY_MCP_HTTP_TOKEN als Bearer-Token, und ohne ihn startet der Server nicht. Host- und Origin-Header werden mit der tatsächlichen Zieladresse abgeglichen, um DNS-Rebinding zu verhindern. Zwei Grenzen solltest du kennen. Alle HTTP-Clients steuern dieselbe Emulator-Instanz, gleichzeitige Agenten können also gegenseitig Pausen, Breakpoints und Speicheränderungen zunichtemachen; das README empfiehlt eine Headless-Instanz pro Agent auf eigenem Port. Und mehrere Tools greifen auf die Festplatte zu: load_media und load_state_file lesen jeden Pfad, den der Prozess erreicht, während save_state_file, start_video_recording und der Trace-Logger Dateien schreiben, Letzterer bis 1 GB oder auf Wunsch unbegrenzt.
Die wichtigste Konkurrenz sind allgemeine Reverse-Engineering-Server wie der für Ghidra, die eine ROM statisch lesen; Gearboy führt sie aus, mit dem Hardware-Zustand, den ein statisches Tool nicht sieht. Gegenüber c64bridge, das Ähnliches für den Commodore 64 über externe Emulatoren leistet, hat es den Vorteil, dass ein Maintainer Emulator und Server zugleich verantwortet. Genau diese Abhängigkeit von einer Person ist das langfristige Risiko, auch wenn der Release-Takt (drei Releases seit dem 24. Oktober) und drei offene Issues auf gute Pflege hindeuten.
Wo es sich lohnt
Ein Homebrew-Entwickler, der ein Spiel mit GBDK-2020 veröffentlicht
Die Routine finden, die in einem vollen Level Frames verliert
Lade die ROM mit ihrer Symboldatei, lass den Agenten den Profiler einige Sekunden laufen und die Funktionen nach Zyklen pro Frame ordnen, und geh dann die schlimmste Schritt für Schritt durch. Kostenlos; es ersetzt einen Abend mit manuellen Breakpoints.
Ein Fan-Übersetzer, der an einem japanischen Game-Boy-Color-Rollenspiel arbeitet
Die Texttabellen und die Routine finden, die Dialoge ausgibt
Bitte den Agenten, den Speicher nach bekannten Zeichenketten zu durchsuchen, Lese-Breakpoints auf die Treffer zu setzen und dem Call Stack bis zur Ausgaberoutine zu folgen, wobei er unterwegs Symbole anlegt. Die Skill gearboy-romhacking beschreibt diesen Ablauf.
Ein Dozent für ein Modul über Retro-Computerarchitektur
Studierenden zeigen, was CPU und LCD während eines Frames tun
Starte Gearboy mit offener Oberfläche, während der Agent Frames weiterschaltet und LCD-Register, Interrupts und Sprite-Tabellen erklärt; Änderungen des Agenten erscheinen gleichzeitig in den Debugger-Fenstern.
Bevor du dich festlegst
- Einrichtung
- Lade einen Desktop-Build herunter oder führe brew install --cask drhelius/geardome/gearboy aus und registriere ihn: claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdio (codex mcp add funktioniert genauso). Der Client startet den Emulator zu Sitzungsbeginn.
- Integrationen
- 76 Tools in 12 Gruppen, ein optionaler Router-Modus mit fünf Discovery-Tools, ein Headless-Modus für Rechner ohne Bildschirm, MCPB-Bundles in der MCP Registry und zwei Agent Skills, installiert mit npx skills add drhelius/gearboy.
- Daten und Datenschutz
- Läuft lokal; Spielspeicher, Screenshots und Disassembly gehen an deinen Modellanbieter. Kein Konto, kein Netzwerkdienst. Der HTTP-Modus lauscht standardmäßig auf 127.0.0.1:7777; Bindungen außerhalb von Loopback brauchen GEARBOY_MCP_HTTP_TOKEN. Die Tools können ROMs und Statusdateien aus jedem Pfad lesen und Savestates, AVI-Aufnahmen und Trace-Logs auf die Festplatte schreiben.
- Kosten im großen Maßstab
- Kostenlos unter GPL-3.0; es fallen nur Modellkosten an, die mit langen Trace-Logs und häufigen Screenshots steigen.
- Grenzen
- Gleichzeitige HTTP-Clients stören sich auf einer Instanz gegenseitig. Ohne --mcp-router ist die vollständige Tool-Liste groß. Trace-Logs können 1 GB erreichen, unbegrenzt eingestellt auch mehr. Unter Windows sind eventuell Visual C++ Redistributable und OpenGL Compatibility Pack nötig.
Was gut ist
- 76 Tools über Debugger, Profiler und Rückspulen
- Standardmäßig stdio; HTTP bindet an Loopback
- HTTP außerhalb von Loopback startet nicht ohne Token
- Fertige Builds, Homebrew-Cask und MCPB-Bundles
Was nicht
- Alle HTTP-Clients teilen sich eine Emulator-Instanz
- Datei-Tools lesen und schreiben jeden erreichbaren Pfad
- Nur die Game-Boy-Familie
- Fast alle Commits stammen von einem Entwickler
Am besten für
Homebrew-Entwickler für den Game Boy, ROM-Hacker und Übersetzer, die einen Agenten ein laufendes Spiel tracen, profilieren und patchen lassen wollen.
Alternativen zu Gearboy
Gearboy: häufige Fragen
- Lohnt sich Gearboy?
- Ein ausgereifter, genauer Emulator, dessen MCP-Server einem Agenten einen vollständigen Debugger in die Hand gibt, mit vernünftigen Netzwerk-Voreinstellungen und vollem Schreibzugriff auf das laufende Spiel. Wir bewerten es mit 4.2 von 5.
- Was kostet Gearboy?
- Kostenlos und Open Source (GPL-3.0). Die Entwicklung wird über GitHub Sponsors finanziert.
- Welche Nachteile hat Gearboy?
- Alle HTTP-Clients teilen sich eine Emulator-Instanz; Datei-Tools lesen und schreiben jeden erreichbaren Pfad; Nur die Game-Boy-Familie; Fast alle Commits stammen von einem Entwickler.
- Für wen eignet sich Gearboy?
- Homebrew-Entwickler für den Game Boy, ROM-Hacker und Übersetzer, die einen Agenten ein laufendes Spiel tracen, profilieren und patchen lassen wollen.
- Was kostet Gearboy für ein Team oder im Produktivbetrieb?
- Kostenlos unter GPL-3.0; es fallen nur Modellkosten an, die mit langen Trace-Logs und häufigen Screenshots steigen.
- Ist Gearboy sicher für Firmendaten?
- Läuft lokal; Spielspeicher, Screenshots und Disassembly gehen an deinen Modellanbieter. Kein Konto, kein Netzwerkdienst. Der HTTP-Modus lauscht standardmäßig auf 127.0.0.1:7777; Bindungen außerhalb von Loopback brauchen GEARBOY_MCP_HTTP_TOKEN. Die Tools können ROMs und Statusdateien aus jedem Pfad lesen und Savestates, AVI-Aufnahmen und Trace-Logs auf die Festplatte schreiben.
- Was sind die besten Alternativen zu Gearboy?
- Die nächsten Alternativen, die wir getestet haben, sind C64 Bridge, GhidraMCP und x64dbg-MCP Server.
Antworten geprüft am 16. Nov. 2026.