O que é Gearboy?
Gearboy é um emulador de código aberto de Game Boy, Game Boy Color e Super Game Boy do desenvolvedor drhelius, escrito em C++, cujo repositório data de 2012. Desde a versão 3.8.0, de março de 2026, que também refez o depurador, ele traz um servidor MCP dentro do próprio emulador, para que um agente como Claude Code ou Codex possa pausar um jogo, executar instruções SM83 uma a uma, ler e gravar memória, definir breakpoints, inspecionar o hardware de LCD e áudio, capturar telas e controlar o joystick enquanto a interface do depurador mostra o mesmo estado.
O repositório tem cerca de 1.220 estrelas, usa a licença GPL-3.0 e lançou a 3.8.21 em 15 de novembro de 2026, com commits na mesma semana. Há builds de desktop para Windows, macOS, Linux e BSD; MCP Bundles (.mcpb) para seis combinações de plataforma e arquitetura são publicados no MCP Registry, e duas Agent Skills cobrem depuração e ROM hacking.
Como instalar Gearboy
claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdioGearboy vale a pena?
O servidor MCP é a porta de entrada para um depurador de verdade, não uma camada rasa. O README do MCP lista 76 ferramentas em 12 grupos: controle de execução até instruções e quadros individuais, registradores da CPU, leitura e escrita em bancos de ROM, VRAM, WRAM, OAM e IO, busca na memória no estilo de um localizador de trapaças, desmontagem com símbolos e marcadores, pilha de chamadas, registro de rastreamento, um profiler por função com contagem de ciclos, navegação no buffer de rebobinagem, save states, trapaças e macros de controle. Arquivos de símbolos de RGBDS, GBDK-2020, WLA-DX e outras toolchains são carregados automaticamente ao lado da ROM, e é isso que torna a desmontagem legível para um modelo.
Uma lista tão longa custa contexto em cada sessão, e a opção --mcp-router resolve isso: 12 ferramentas de uso frequente ficam diretas e o resto é encontrado por cinco ferramentas de descoberta, como search_tools e get_tool_info. O padrão expõe tudo diretamente, porque clientes como Claude Code já carregam os esquemas sob demanda.
Na exposição de rede, os padrões são cuidadosos. Stdio é o transporte recomendado e não abre nenhuma porta. O modo HTTP, iniciado com --mcp-http ou pelo menu MCP, escuta em 127.0.0.1:7777/mcp; ali ele pode rodar sem token, mas qualquer endereço curinga ou fora do loopback exige GEARBOY_MCP_HTTP_TOKEN como token bearer, e o servidor se recusa a iniciar sem ele. Os cabeçalhos Host e Origin são comparados ao endereço de destino real para bloquear DNS rebinding. Vale conhecer dois limites. Todos os clientes HTTP controlam a mesma instância do emulador, então agentes simultâneos podem desfazer pausas, breakpoints e escritas de memória uns dos outros; o README sugere uma instância headless por agente, cada uma na sua porta. E várias ferramentas mexem no disco: load_media e load_state_file leem qualquer caminho que o processo alcance, enquanto save_state_file, start_video_recording e o registro de rastreamento gravam arquivos, este último até 1 GB, ou sem limite se pedido.
A principal concorrência são servidores gerais de engenharia reversa, como o do Ghidra, que leem uma ROM de forma estática; o Gearboy a executa, com o estado do hardware que uma ferramenta estática não enxerga. Diante do c64bridge, que faz trabalho parecido para o Commodore 64 por meio de emuladores externos, ele tem a vantagem de um mesmo mantenedor ser dono do emulador e do servidor. Essa mesma dependência de uma pessoa é o risco de longo prazo, embora o ritmo de lançamentos (três desde 24 de outubro) e as três issues abertas indiquem um projeto bem cuidado.
Onde ele se destaca
Um desenvolvedor de homebrew lançando um jogo feito com GBDK-2020
Encontrar a rotina que derruba quadros em uma fase pesada
Carregue a ROM com o arquivo de símbolos, peça ao agente que rode o profiler por alguns segundos e ordene as funções por ciclos por quadro, e depois percorra passo a passo a pior. Gratuito; substitui uma noite de breakpoints manuais.
Um tradutor amador trabalhando em um RPG japonês de Game Boy Color
Localizar as tabelas de texto e a rotina que imprime os diálogos
Peça ao agente que procure na memória strings conhecidas, coloque breakpoints de leitura nos resultados e siga a pilha de chamadas até a rotina de impressão, adicionando símbolos pelo caminho. A skill gearboy-romhacking descreve esse fluxo.
Um professor de uma disciplina de arquitetura de computadores retrô
Mostrar aos alunos o que a CPU e o LCD fazem durante um quadro
Rode o Gearboy com a interface aberta enquanto o agente avança quadros e explica registradores do LCD, interrupções e tabelas de sprites; as mudanças que o agente faz aparecem ao mesmo tempo nas janelas do depurador.
Antes de decidir
- Configuração
- Baixe um build de desktop ou rode brew install --cask drhelius/geardome/gearboy e registre-o: claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdio (codex mcp add funciona do mesmo jeito). O cliente abre o emulador quando a sessão começa.
- Integrações
- 76 ferramentas em 12 grupos, um modo router opcional com cinco ferramentas de descoberta, modo headless para máquinas sem tela, pacotes MCPB no MCP Registry e duas Agent Skills instaladas com npx skills add drhelius/gearboy.
- Dados e privacidade
- Roda localmente; memória do jogo, capturas e desmontagem vão para o seu provedor de modelos. Sem conta nem serviço de rede. O modo HTTP escuta em 127.0.0.1:7777 por padrão; vínculos fora do loopback exigem GEARBOY_MCP_HTTP_TOKEN. As ferramentas podem ler ROMs e arquivos de estado de qualquer caminho e gravar no disco save states, gravações AVI e registros de rastreamento.
- Custo em escala
- Gratuito sob GPL-3.0; o único custo é o uso do modelo, que cresce com registros de rastreamento longos e capturas frequentes.
- Limites
- Clientes HTTP simultâneos interferem uns nos outros em uma mesma instância. Sem --mcp-router, a lista completa de ferramentas é grande. Registros de rastreamento podem chegar a 1 GB, ou mais se configurados sem limite. No Windows podem ser necessários Visual C++ Redistributable e OpenGL Compatibility Pack.
O que é bom
- 76 ferramentas sobre depurador, profiler e rebobinagem completos
- Stdio por padrão; HTTP vinculado ao loopback
- HTTP fora do loopback não inicia sem token
- Builds prontos, cask do Homebrew e pacotes MCPB
O que não é
- Todos os clientes HTTP compartilham uma instância do emulador
- Ferramentas de arquivo leem e gravam qualquer caminho acessível
- Somente a família Game Boy
- Um desenvolvedor assina quase todos os commits
Ideal para
Desenvolvedores de homebrew para Game Boy, ROM hackers e tradutores que querem que um agente rastreie, faça profiling e aplique patches em um jogo em execução.
Alternativas ao Gearboy
Gearboy: perguntas frequentes
- Gearboy vale a pena?
- Um emulador maduro e preciso cujo servidor MCP entrega um depurador completo a um agente, com padrões de rede sensatos e acesso total de escrita ao jogo em execução. Damos nota 4.2 de 5.
- Quanto custa Gearboy?
- Gratuito e de código aberto (GPL-3.0). O desenvolvimento é financiado pelo GitHub Sponsors.
- Quais são as desvantagens de Gearboy?
- Todos os clientes HTTP compartilham uma instância do emulador; ferramentas de arquivo leem e gravam qualquer caminho acessível; somente a família Game Boy; um desenvolvedor assina quase todos os commits.
- Para quem Gearboy é indicado?
- Desenvolvedores de homebrew para Game Boy, ROM hackers e tradutores que querem que um agente rastreie, faça profiling e aplique patches em um jogo em execução.
- Quanto custa Gearboy para uma equipe ou em produção?
- Gratuito sob GPL-3.0; o único custo é o uso do modelo, que cresce com registros de rastreamento longos e capturas frequentes.
- Gearboy é seguro para dados da empresa?
- Roda localmente; memória do jogo, capturas e desmontagem vão para o seu provedor de modelos. Sem conta nem serviço de rede. O modo HTTP escuta em 127.0.0.1:7777 por padrão; vínculos fora do loopback exigem GEARBOY_MCP_HTTP_TOKEN. As ferramentas podem ler ROMs e arquivos de estado de qualquer caminho e gravar no disco save states, gravações AVI e registros de rastreamento.
- Quais são as melhores alternativas ao Gearboy?
- As alternativas mais próximas que analisamos são C64 Bridge, GhidraMCP e x64dbg-MCP Server.
Respostas verificadas em 16 de nov. de 2026.