Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

Gearboy

Emulador de Game Boy e Game Boy Color com servidor MCP embutido: 76 ferramentas de depuração para breakpoints, memória, desmontagem e rebobinagem.

Análise de ReviewRamble editors · Atualizado

Guia de instalação Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

4.2/5

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.

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-stdio

Gearboy 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.

Você faz o Gearboy? Mostre esta nota no seu siteGearboy com nota 4.2 de 5 no ReviewRamble