/ الدليل / الملعب / Gearboy
● مجتمع drhelius ⚡ فوري

Gearboy

بواسطة drhelius · drhelius/Gearboy

محاكي Game Boy / Game Boy Color مع خادم MCP مضمن لتصحيح الأخطاء وتحليل ROM بمساعدة الذكاء الاصطناعي.

Gearboy عبارة عن محاكي Game Boy وGame Boy Color وSuper Game Boy متعدد المنصات مكتوب بلغة C++ مع خادم MCP مضمن. يمكن لوكلاء الذكاء الاصطناعي التحكم في التنفيذ (الإيقاف المؤقت، والخطوة، والاستئناف)، وفحص الذاكرة، وتعيين نقاط التوقف، وتفكيك التعليمات البرمجية، ومراقبة حالة الأجهزة في الوقت الفعلي. يدعم نقل stdio وHTTP (المنفذ 7777). يعمل على أنظمة التشغيل macOS، وWindows، وLinux، وBSD، و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

كيفية تصحيح أخطاء Game Boy ROM بمساعدة الذكاء الاصطناعي باستخدام Gearboy

👤 مطورو Homebrew Game Boy وقراصنة ROM ⏱ ~30 min intermediate

متى تستخدمه: أنت تقوم بتطوير ROM من Game Boy homebrew وتحتاج إلى تصحيح مشكلات وقت التشغيل.

المتطلبات الأساسية
  • تم تصميم Gearboy بدعم MCP — البناء من المصدر باتباع GitHub README
  • ملف Game Boy ROM (.gb أو .gbc) — ROM الخاص بالبيرة المنزلية أو ROM الذي تملكه قانونًا
الخطوات
  1. تحميل ROM والاتصال
    اتصل بخادم Gearboy MCP وقم بتحميل ROM الخاص بي. أرني حالة وحدة المعالجة المركزية الحالية والتفكيك في عداد البرنامج.✓ تم النسخ
    → سجلات وحدة المعالجة المركزية، والأعلام، والتعليمات المفككة على جهاز الكمبيوتر
  2. تعيين نقطة توقف والتحقيق
    قم بتعيين نقطة توقف عند العنوان 0x0150 (بعد الرأس). خطوة خلال التنفيذ وشرح ما تفعله كل تعليمات.✓ تم النسخ
    → التنفيذ خطوة بخطوة مع شرح التعليمات
  3. فحص الذاكرة
    أرني محتويات WRAM من 0xC000 إلى 0xC0FF. هل هناك أي هياكل بيانات يمكن التعرف عليها؟✓ تم النسخ
    → تفريغ الذاكرة مع تحليل أنماط البيانات

النتيجة: فهم واضح لكيفية تنفيذ ROM، مع تحديد الأخطاء وشرحها.

المزالق
  • تعمل نقاط التوقف على العناوين التي يتم ضربها بشكل متكرر على إبطاء التنفيذ بشكل كبير — استخدم نقاط التوقف الشرطية أو قم بتعيينها فقط عندما تكون قريبًا من الخطأ
اجمعها مع: filesystem

تعلم هندسة Game Boy بشكل تفاعلي مع الذكاء الاصطناعي وGearboy

👤 يتعلم الطلاب أجهزة وحدة التحكم القديمة وتجميعها ⏱ ~45 min intermediate

متى تستخدمه: تريد أن تفهم كيفية عمل وحدة المعالجة المركزية والذاكرة والرسومات في Game Boy بشكل عملي.

المتطلبات الأساسية
  • Gearboy مع خادم MCP — البناء من المصدر
  • ROM اختبار بسيط — استخدم ROM اختبار البيرة المنزلية أو ROM اختبار Blargg
الخطوات
  1. استكشاف خريطة الذاكرة
    أرني خريطة ذاكرة Game Boy. اقرأ رأس ROM على 0x0100-0x014F واشرح كل حقل.✓ تم النسخ
    → رأس مشروح مع العنوان ونوع الخرطوشة وأحجام ROM/RAM
  2. شاهد VRAM أثناء العمل
    انتقل عبر معالج المقاطعة VBlank واشرح كيفية تحميل المربعات في VRAM.✓ تم النسخ
    → شرح خطوة بخطوة لتحميل التجانب مع حالة VRAM

النتيجة: الفهم العملي لأجهزة Game Boy من خلال الاستكشاف التفاعلي.

المزالق
  • يمكن أن يكون التجميع ساحقًا للمبتدئين — ابدأ باستخدام ذاكرة القراءة فقط (ROM) الاختبارية البسيطة التي تستخدم ميزة واحدة من ميزات الأجهزة في كل مرة

التركيبات

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

gearboy-2 + filesystem

تصدير عمليات تفريغ الذاكرة وسجلات تصحيح الأخطاء للتحليل في وضع عدم الاتصال

قم بتفريغ محتويات VRAM بالكامل في ملف وقم بتعليق تخطيط بيانات التجانب.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
pause/resume/step none / step_count? التحكم في تنفيذ المحاكي 0
read_memory address: int, size: int قراءة ذاكرة المحاكي في أي عنوان 0
write_memory address: int, data: bytes الكتابة إلى ذاكرة المحاكي 0
set_breakpoint address: int, type?: str قم بتعيين وحدة المعالجة المركزية أو نقطة توقف الذاكرة 0
disassemble address: int, count: int تفكيك التعليمات في العنوان 0
get_cpu_state none احصل على سجلات وأعلام وحدة المعالجة المركزية الحالية 0

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

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

حصة API
غير متاح - محلي بالكامل
الرموز لكل استدعاء
100-500 رمز مميز لكل أمر تصحيح
التكلفة المالية
حرة ومفتوحة المصدر (ترخيص معهد ماساتشوستس للتكنولوجيا)
نصيحة
استخدم قراءات الذاكرة المستهدفة بدلاً من عمليات التفريغ الكاملة للحفاظ على انخفاض استخدام الرمز المميز.

الأمان

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

تخزين بيانات الاعتماد: لا يوجد
نقل البيانات الخارجي: محلي بالكامل - لا توجد مكالمات عبر الشبكة

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

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

MCP server not responding

تأكد من تصميم Gearboy مع تمكين دعم MCP. تأكد من أن منفذ الخادم (الافتراضي 7777) ليس قيد الاستخدام.

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

تحقق من أن ملف ROM هو ملف صالح بتنسيق .gb أو .gbc. تأكد من أن الملف غير تالف.

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

تأكد من أن العنوان موجود في مسار التنفيذ. استخدم أداة التفكيك للتحقق مما إذا كان الكود يعمل بالفعل على هذا العنوان.

تحقق: Disassemble around the target address

البدائل

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

البديلمتى تستخدمهاالمقايضة
Geargrafxتريد تصحيح أخطاء ROM PC Engine / TurboGrafx-16 بدلاً من Game Boyوحدة تحكم مختلفة، نفس أسلوب المحاكي الذي يدعم MCP من قبل نفس المطور

المزيد

الموارد

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

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

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