Gearboyとは?
Gearboyは開発者drheliusによるゲームボーイ、ゲームボーイカラー、スーパーゲームボーイのオープンソースエミュレーターで、C++で書かれ、リポジトリは2012年にさかのぼります。デバッガーも作り直した2026年3月のバージョン3.8.0から、エミュレーター本体にMCPサーバーを内蔵しています。Claude CodeやCodexなどのエージェントは、ゲームを一時停止し、SM83命令を1つずつ実行し、メモリを読み書きし、ブレークポイントを設定し、LCDと音声のハードウェアを調べ、画面をキャプチャし、コントローラーを操作できます。その間、デバッガーのGUIにも同じ状態が表示されます。
リポジトリのスター数は約1,220、ライセンスはGPL-3.0で、2026年11月15日に3.8.21をリリースし、同じ週にもコミットがあります。デスクトップ版はWindows、macOS、Linux、BSDに対応します。6通りのプラットフォームとアーキテクチャ向けのMCP Bundles(.mcpb)がMCP Registryで公開され、デバッグとROMハック用に2つのAgent Skillsがあります。
Gearboyのインストール方法
claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdioGearboyは使う価値があるか?
このMCPサーバ ーは薄いラッパーではなく、本物のデバッガーへの入り口です。MCPのREADMEは12グループ、76のツールを挙げています。1命令・1フレーム単位までの実行制御、CPUレジスタ、ROMバンク、VRAM、WRAM、OAM、IOの読み書き、チート検索のようなメモリ検索、シンボルとブックマーク付きの逆アセンブル、コールスタック、トレースロガー、サイクル数を出す関数単位のプロファイラー、巻き戻しバッファ内の移動、セーブステート、チート、コントローラーのマクロです。RGBDS、GBDK-2020、WLA-DXなどのツールチェーンのシンボルファイルはROMの隣にあれば自動で読み込まれ、これが逆アセンブルをモデルにとって読めるものにしています。
これだけ長い一覧は毎回のセッションでコンテキストを消費しますが、--mcp-routerフラグがその対策です。よく使う12のツールは直接公開し、残りはsearch_toolsやget_tool_infoなど5つの探索用ツールで見つけます。Claude Codeのようにツールのスキーマを後から読み込むクライアントがあるため、既定ではすべてを直接公開します。
ネットワークへの露出に関する初期設定は慎重です。推奨トランスポートはstdioで、ポートは開きません。--mcp-httpまたはMCPメニューで起動するHTTPモードは127.0.0.1:7777/mcpで待ち受けます。ここではトークンなしでも動きますが、ワイルドカードやループバック以外のアドレスではGEARBOY_MCP_HTTP_TOKENをBearerトークンとして必須とし、なければサーバーは起動しません。DNSリバインディングを防ぐため、HostとOriginヘッダーは実際の接続先アドレスと照合されます。知っておくべき制限が2つあります。すべてのHTTPクライアントが同じエミュレーターのインスタンスを操作す るため、同時に動くエージェントは互いの一時停止、ブレークポイント、メモリ書き込みを打ち消し合うことがあります。READMEはエージェントごとに別ポートでheadlessインスタンスを1つずつ動かすよう勧めています。また、いくつかのツールはディスクに触れます。load_mediaとload_state_fileはプロセスが届くあらゆるパスを読み、save_state_file、start_video_recording、トレースロガーはファイルを書き込みます。トレースロガーは最大1 GB、指定すれば無制限です。
主な競合は、ROMを静的に読むGhidra用などの汎用リバースエンジニアリングサーバーです。GearboyはROMを実際に動かし、静的ツールでは見えないハードウェアの状態を示します。外部エミュレーター経由でコモドール64向けに似た作業をするc64bridgeと比べると、1人のメンテナーがエミュレーターとサーバーの両方を管理している点が強みです。同じ1人体制が長期的なリスクでもありますが、リリースの頻度(10月24日以降に3回)と未解決のissueが3件という状況は、よく手入れされていることを示しています。
真価を発揮する場面
GBDK-2020で作ったゲームを公開するhomebrew開発者
負荷の高いステージでフレーム落ちを起こしているルーチンを見つける
シンボルファイル付きでROMを読み込み、エージェントに数秒間プロファイラーを動かさせて関数をフレームあたりのサイクル数で並べ、最も重い関数をステップ実行します。無料で、手作業でブレークポイントを置く一晩分の作業を置き換えます。
日本のゲームボーイカラー用RPGを翻訳するファン翻訳者
テキストテーブルと会話を表示するルーチンを突き止める
エージェントに既知の文字列をメモリ検索させ、見つかった箇所に読み取りブレークポイントを置き、コールスタックをたどって表示ルーチンまでさかのぼらせ、途中でシンボルを追加させます。gearboy-romhackingスキルがこの手順を説明しています。
レトロなコンピューターアーキテクチャを教える講師
1フレームの間にCPUとLCDが何をしているかを学生に見せる
GUIを開いたままGearboyを動かし、エージェントにフレームを進めさせながらLCDレジスタ、割り込み、スプライトテーブルを説明させます。エージェントの変更はデバッガーのウィンドウにも同時に表示されます。
導入前に確認すること
- 導入
- デスクトップ版をダウンロードするか、brew install --cask drhelius/geardome/gearboyを実行し、claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdioで登録します(codex mcp addも同様です)。セッション開始時にクライアントがエミュレーターを起動します。
- 連携
- 12グループ76のツール、5つの探索用ツールを持つ任意のルーターモード、画面のないマシン向けのheadlessモード、MCP RegistryのMCPBバンドル、npx skills add drhelius/gearboyで入る2つのAgent Skillsがあります。
- データとプライバシー
- ローカルで動作し、ゲームのメモリ、スクリーンショット、逆アセンブル結果はモデル提供元に送られます。アカウントやネットワークサービスは不要です。HTTPモードは既定で127.0.0.1:7777で待ち受け、ループバック外へのバインドにはGEARBOY_MCP_HTTP_TOKENが必要です。ツールは任意のパスからROMやステートファイルを読み、セーブステート、AVI録画、トレースログをディスクに書き込めます。
- 大規模利用時のコスト
- GPL-3.0のもとで無料です。かかるのはモデルの利用料だけで、長いトレースログや頻繁なスクリーンショットで増えます。
- 制限
- 同時に接続したHTTPクライアントは1つのインスタンス上で互いに干渉します。--mcp-routerなしではツール一覧が大きくなります。トレースログは1 GBに達し、無制限に設定すればそれ以上になります。WindowsではVisual C++ RedistributableとOpenGL Compatibility Packが必要な場合があります。
良い点
- デバッガー、プロファイラー、巻き戻しを覆う76のツール
- 既定はstdio、HTTPはループバックにバインド
- ループバック外のHTTPはトークンなしでは起動しない
- ビルド済みパッケージ、Homebrew cask、MCPBバンドル
気になる点
- すべてのHTTPクライアントが1つのインスタンスを共有
- ファイル系ツールは到達できる任意のパスを読み書きする
- ゲームボーイ系のみ
- コミットのほぼすべてが1人の開発者
おすすめの人
実行中のゲームのトレース、プロファイリング、パッチ当てをエージェントに任せたい、ゲームボーイのhomebrew開発者、ROMハッカー、翻訳者に向いています。
Gearboyの代替
Gearboy:よくある質問
- Gearboyは使う価値があるか?
- 成熟した正確なエミュレーターで、そのMCPサーバーはエージェントに本格的なデバッガーを渡します。ネットワークの初期設定は慎重で、実行中のゲームへの書き込み権限はすべて与えます。 評価は5点満点中4.2点です。
- Gearboyの料金は?
- 無料のオープンソース(GPL-3.0)です。開発はGitHub Sponsorsで支えられています。
- Gearboyの欠点は?
- すべてのHTTPクライアントが1つのインスタンスを共有; ファイル系ツールは到達できる任意のパスを読み書きする; ゲームボーイ系のみ; コミットのほぼすべてが1人の開発者.
- Gearboyは誰に向いているか?
- 実行中のゲームのトレース、プロファイリング、パッチ当てをエージェントに任せたい、ゲームボーイのhomebrew開発者、ROMハッカー、翻訳者に向いています。
- チームや本番環境でGearboyを使うと費用はいくらか?
- GPL-3.0のもとで無料です。かかるのはモデルの利用料だけで、長いトレースログや頻繁なスクリーンショットで増えます。
- Gearboyは企業データを扱っても安全か?
- ローカルで動作し、ゲームのメモリ、スクリーンショット、逆アセンブル結果はモデル提供元に送られます。アカウントやネットワークサービスは不要です。HTTPモードは既定で127.0.0.1:7777で待ち受け、ループバック外へのバインドにはGEARBOY_MCP_HTTP_TOKENが必要です。ツールは任意のパスからROMやステートファイルを読み、セーブステート、AVI録画、トレースログをディスクに書き込めます。
- Gearboyの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はC64 Bridge, GhidraMCP 、 x64dbg-MCP Serverです。
回答確認日:2026年11月16日