Qu’est-ce que Gearboy ?
Gearboy est un émulateur open source de Game Boy, Game Boy Color et Super Game Boy du développeur drhelius, écrit en C++, dont le dépôt remonte à 2012. Depuis la version 3.8.0 de mars 2026, qui a aussi refondu le débogueur, il embarque un serveur MCP dans l'émulateur lui-même : un agent comme Claude Code ou Codex peut mettre un jeu en pause, exécuter les instructions SM83 une à une, lire et écrire la mémoire, poser des breakpoints, inspecter le matériel LCD et audio, capturer l'écran et piloter la manette pendant que l'interface du débogueur affiche le même état.
Le dépôt compte environ 1 220 étoiles, est sous licence GPL-3.0 et a publié la 3.8.21 le 15 novembre 2026, avec des commits la même semaine. Des builds de bureau existent pour Windows, macOS, Linux et BSD ; des MCP Bundles (.mcpb) pour six combinaisons de plateforme et d'architecture sont publiés dans le MCP Registry, et deux Agent Skills couvrent le débogage et le ROM hacking.
Installer Gearboy
claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdioGearboy vaut-il le coup ?
Le serveur MCP donne accès à un vrai débogueur, pas à une simple surcouche. Le README MCP liste 76 outils répartis en 12 groupes : contrôle de l'exécution jusqu'à l'instruction et à l'image près, registres du processeur, lecture et écriture dans les banques ROM, la VRAM, la WRAM, l'OAM et les IO, recherche en mémoire façon chercheur de codes de triche, désassemblage avec symboles et signets, pile d'appels, journal de traces, profileur par fonction avec décompte des cycles, déplacement dans le tampon de retour arrière, sauvegardes d'état, codes de triche et macros de manette. Les fichiers de symboles de RGBDS, GBDK-2020, WLA-DX et d'autres chaînes se chargent seuls à côté de la ROM, et c'est ce qui rend le désassemblage lisible pour un modèle.
Une liste aussi longue coûte du contexte à chaque session, et l'option --mcp-router y répond : 12 outils fréquents restent directs, les autres se trouvent via cinq outils de découverte comme search_tools et get_tool_info. Par défaut, tout est exposé directement, car des clients comme Claude Code chargent déjà les schémas à la demande.
Côté exposition réseau, les réglages par défaut sont prudents. Stdio est le transport recommandé et n'ouvre aucun port. Le mode HTTP, lancé avec --mcp-http ou depuis le menu MCP, écoute sur 127.0.0.1:7777/mcp ; il peut y tourner sans jeton, mais toute adresse générique ou hors loopback exige GEARBOY_MCP_HTTP_TOKEN comme jeton bearer, et le serveur refuse de démarrer sans lui. Les en-têtes Host et Origin sont comparés à l'adresse de destination réelle pour bloquer le DNS rebinding. Deux limites sont à connaître. Tous les clients HTTP pilotent la même instance de l'émulateur, si bien que des agents simultanés peuvent défaire les pauses, breakpoints et écritures mémoire des autres ; le README conseille une instance headless par agent sur son propre port. Et plusieurs outils touchent au disque : load_media et load_state_file lisent tout chemin accessible au processus, tandis que save_state_file, start_video_recording et le journal de traces écrivent des fichiers, ce dernier jusqu'à 1 Go, ou sans limite si on le demande.
La concurrence principale vient de serveurs de rétro-ingénierie généralistes comme celui de Ghidra, qui lisent une ROM de façon statique ; Gearboy l'exécute, avec l'état matériel qu'un outil statique ne voit pas. Face à c64bridge, qui fait un travail voisin pour le Commodore 64 via des émulateurs externes, il a l'avantage qu'un même mainteneur possède l'émulateur et son serveur. Cette dépendance à une seule personne est aussi le risque à long terme, même si le rythme des versions (trois depuis le 24 octobre) et les trois tickets ouverts montrent un projet bien tenu.
Là où il fait la différence
Un développeur homebrew qui publie un jeu conçu avec GBDK-2020
Trouver la routine qui fait perdre des images dans un niveau chargé
Chargez la ROM avec son fichier de symboles, laissez l'agent lancer le profileur quelques secondes et classer les fonctions par cycles par image, puis parcourez pas à pas la pire. Gratuit ; cela remplace une soirée de breakpoints posés à la main.
Un traducteur amateur qui travaille sur un RPG japonais pour Game Boy Color
Localiser les tables de texte et la routine qui affiche les dialogues
Demandez à l'agent de chercher en mémoire des chaînes connues, de poser des breakpoints de lecture sur les résultats et de remonter la pile d'appels jusqu'à la routine d'affichage, en ajoutant des symboles au passage. La skill gearboy-romhacking décrit ce déroulé.
Un enseignant d'un module d'architecture des ordinateurs rétro
Montrer aux étudiants ce que font le processeur et l'écran LCD pendant une image
Lancez Gearboy avec l'interface ouverte pendant que l'agent avance image par image et explique les registres LCD, les interruptions et les tables de sprites ; les changements de l'agent apparaissent en même temps dans les fenêtres du débogueur.
Avant de vous engager
- Mise en route
- Téléchargez un build de bureau ou lancez brew install --cask drhelius/geardome/gearboy, puis enregistrez-le : claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdio (codex mcp add fonctionne de la même façon). Le client lance l'émulateur à l'ouverture de la session.
- Intégrations
- 76 outils en 12 groupes, un mode routeur optionnel avec cinq outils de découverte, un mode headless pour les machines sans écran, des bundles MCPB dans le MCP Registry et deux Agent Skills installées avec npx skills add drhelius/gearboy.
- Données et confidentialité
- Fonctionne en local ; la mémoire du jeu, les captures et le désassemblage partent chez votre fournisseur de modèles. Ni compte ni service réseau. Le mode HTTP écoute sur 127.0.0.1:7777 par défaut ; les liaisons hors loopback exigent GEARBOY_MCP_HTTP_TOKEN. Les outils peuvent lire des ROM et des fichiers d'état sur n'importe quel chemin et écrire sur disque des sauvegardes d'état, des enregistrements AVI et des journaux de traces.
- Coût à grande échelle
- Gratuit sous GPL-3.0 ; le seul coût est l'usage du modèle, qui augmente avec les longs journaux de traces et les captures fréquentes.
- Limites
- Des clients HTTP simultanés se gênent sur une même instance. Sans --mcp-router, la liste complète d'outils est volumineuse. Les journaux de traces peuvent atteindre 1 Go, davantage s'ils sont réglés sans limite. Sous Windows, Visual C++ Redistributable et OpenGL Compatibility Pack peuvent être nécessaires.
Les points forts
- 76 outils sur un débogueur, un profileur et un retour arrière complets
- Stdio par défaut ; HTTP lié à loopback
- Le HTTP hors loopback refuse de démarrer sans jeton
- Builds prêts à l'emploi, cask Homebrew et bundles MCPB
Les points faibles
- Tous les clients HTTP partagent une seule instance
- Les outils de fichiers lisent et écrivent tout chemin accessible
- Famille Game Boy uniquement
- Un développeur signe presque tous les commits
Idéal pour
Développeurs homebrew sur Game Boy, ROM hackers et traducteurs qui veulent qu'un agent trace, profile et modifie un jeu en cours d'exécution.
Alternatives à Gearboy
Gearboy : questions fréquentes
- Gearboy vaut-il le coup ?
- Un émulateur mûr et précis dont le serveur MCP confie un débogueur complet à un agent, avec des réglages réseau prudents par défaut et un accès total en écriture au jeu en cours. Nous lui donnons 4.2 sur 5.
- Combien coûte Gearboy ?
- Gratuit et open source (GPL-3.0). Le développement est financé par GitHub Sponsors.
- Quels sont les inconvénients de Gearboy ?
- Tous les clients HTTP partagent une seule instance; les outils de fichiers lisent et écrivent tout chemin accessible; famille Game Boy uniquement; un développeur signe presque tous les commits.
- À qui s’adresse Gearboy ?
- Développeurs homebrew sur Game Boy, ROM hackers et traducteurs qui veulent qu'un agent trace, profile et modifie un jeu en cours d'exécution.
- Combien coûte Gearboy pour une équipe ou en production ?
- Gratuit sous GPL-3.0 ; le seul coût est l'usage du modèle, qui augmente avec les longs journaux de traces et les captures fréquentes.
- Gearboy est-il sûr pour les données de l’entreprise ?
- Fonctionne en local ; la mémoire du jeu, les captures et le désassemblage partent chez votre fournisseur de modèles. Ni compte ni service réseau. Le mode HTTP écoute sur 127.0.0.1:7777 par défaut ; les liaisons hors loopback exigent GEARBOY_MCP_HTTP_TOKEN. Les outils peuvent lire des ROM et des fichiers d'état sur n'importe quel chemin et écrire sur disque des sauvegardes d'état, des enregistrements AVI et des journaux de traces.
- Quelles sont les meilleures alternatives à Gearboy ?
- Les alternatives les plus proches que nous avons testées sont C64 Bridge, GhidraMCP et x64dbg-MCP Server.
Réponses vérifiées le 16 nov. 2026.