/ الدليل / الملعب / Gearboy
← كل الخوادم ↗ GitHub
● مجتمع drhelius ⚡ فوري

Gearboy

بواسطة drhelius · drhelius/Gearboy

Game Boy / Game Boy Color emulator with an embedded MCP server for AI-assisted debugging and ROM analysis.

Gearboy is a cross-platform Game Boy, Game Boy Color, and Super Game Boy emulator written in C++ with an embedded MCP server. AI agents can control execution (pause, step, resume), inspect memory, set breakpoints, disassemble code, and monitor hardware state in real-time. Supports stdio and HTTP transport (port 7777). Runs on macOS, Windows, Linux, BSD, and RetroArch.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

gearboy-2.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gearboy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drhelius/Gearboy"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "gearboy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drhelius/Gearboy"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "gearboy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drhelius/Gearboy"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gearboy-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drhelius/Gearboy"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "gearboy-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/drhelius/Gearboy"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "gearboy-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/drhelius/Gearboy"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add gearboy-2 -- TODO 'See README: https://github.com/drhelius/Gearboy'

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Gearboy

How to debug a Game Boy ROM with AI assistance using Gearboy

👤 Homebrew Game Boy developers and ROM hackers ⏱ ~30 min intermediate

متى تستخدمه: You're developing a Game Boy homebrew ROM and need to debug runtime issues.

المتطلبات الأساسية
  • Gearboy built with MCP support — Build from source following the GitHub README
  • A Game Boy ROM file (.gb or .gbc) — Your own homebrew ROM or a ROM you legally own
الخطوات
  1. Load ROM and connect
    Connect to the Gearboy MCP server and load my ROM. Show me the current CPU state and disassembly at the program counter.✓ تم النسخ
    → CPU registers, flags, and disassembled instructions at PC
  2. Set a breakpoint and investigate
    Set a breakpoint at address 0x0150 (after the header). Step through execution and explain what each instruction does.✓ تم النسخ
    → Step-by-step execution with instruction explanations
  3. Inspect memory
    Show me the contents of WRAM from 0xC000 to 0xC0FF. Are there any recognizable data structures?✓ تم النسخ
    → Memory dump with analysis of data patterns

النتيجة: A clear understanding of how the ROM executes, with bugs identified and explained.

المزالق
  • Breakpoints on frequently-hit addresses slow execution dramatically — Use conditional breakpoints or set them only when you're close to the bug
اجمعها مع: filesystem

Learn Game Boy architecture interactively with AI and Gearboy

👤 Students learning retro console hardware and assembly ⏱ ~45 min intermediate

متى تستخدمه: You want to understand how the Game Boy CPU, memory, and graphics work hands-on.

المتطلبات الأساسية
  • Gearboy with MCP server — Build from source
  • A simple test ROM — Use a homebrew test ROM or Blargg's test ROMs
الخطوات
  1. Explore the memory map
    Show me the Game Boy memory map. Read the ROM header at 0x0100-0x014F and explain each field.✓ تم النسخ
    → Annotated header with title, cartridge type, ROM/RAM sizes
  2. Watch VRAM in action
    Step through the VBlank interrupt handler and explain how tiles are loaded into VRAM.✓ تم النسخ
    → Step-by-step explanation of tile loading with VRAM state

النتيجة: Hands-on understanding of Game Boy hardware through interactive exploration.

المزالق
  • Assembly can be overwhelming for beginners — Start with simple test ROMs that exercise one hardware feature at a time

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

gearboy-2 + filesystem

Export memory dumps and debug logs for offline analysis

Dump the entire VRAM contents to a file and annotate the tile data layout.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
pause/resume/step none / step_count? Control emulator execution 0
read_memory address: int, size: int Read emulator memory at any address 0
write_memory address: int, data: bytes Write to emulator memory 0
set_breakpoint address: int, type?: str Set a CPU or memory breakpoint 0
disassemble address: int, count: int Disassemble instructions at an address 0
get_cpu_state none Get current CPU registers and flags 0

التكلفة والحدود

تكلفة التشغيل

حصة API
N/A — fully local
الرموز لكل استدعاء
100–500 tokens per debug command
التكلفة المالية
Free and open source (MIT license)
نصيحة
Use targeted memory reads instead of full dumps to keep token usage low.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: N/A
نقل البيانات الخارجي: Fully local — no network calls

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

MCP server not responding

Ensure Gearboy was built with MCP support enabled. Check that the server port (default 7777) is not in use.

تحقق: curl http://localhost:7777/health
ROM fails to load

Verify the ROM file is a valid .gb or .gbc file. Check the file isn't corrupted.

تحقق: Check the ROM header with a hex editor
Breakpoint never hits

Verify the address is in the execution path. Use the disassembler to check if code actually runs at that address.

تحقق: Disassemble around the target address

البدائل

Gearboy مقابل البدائل

البديلمتى تستخدمهاالمقايضة
GeargrafxYou want to debug PC Engine / TurboGrafx-16 ROMs instead of Game BoyDifferent console, same MCP-enabled emulator approach by the same developer

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills