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

Geargrafx

بواسطة drhelius · drhelius/Geargrafx

PC Engine / TurboGrafx-16 emulator with an embedded MCP server for AI-assisted debugging and retro game analysis.

Geargrafx is a cross-platform TurboGrafx-16 / PC Engine / SuperGrafx / PCE CD-ROM² emulator written in C++ with an embedded MCP server. AI agents can control execution, inspect memory, set breakpoints, disassemble HuC6280 code, view sprites/tiles, and inspect CD-ROM subsystem state. Supports stdio and HTTP transport, Multi Tap (5 players), save states with previews, and VGM recording.

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

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

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

عرض مباشر

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

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

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

How to debug a PC Engine ROM with AI assistance using Geargrafx

👤 PC Engine homebrew developers and retro game researchers ⏱ ~30 min intermediate

متى تستخدمه: You're developing or analyzing a PC Engine ROM and need to debug runtime behavior.

المتطلبات الأساسية
  • Geargrafx built with MCP support — Build from source following the GitHub README
  • A PC Engine ROM file (.pce or .sgx) — Your own homebrew ROM or a ROM you legally own
الخطوات
  1. Connect and inspect
    Connect to the Geargrafx MCP server. Show me the current HuC6280 CPU state and disassembly at the program counter.✓ تم النسخ
    → CPU registers and disassembled instructions
  2. Analyze sprite system
    Inspect the VDC sprite table. How many sprites are active and what tiles do they reference?✓ تم النسخ
    → Sprite attribute table with positions, tile indices, and flags

النتيجة: Understanding of ROM execution and VDC hardware state for debugging.

المزالق
  • CD-ROM games require proper CUE/BIN setup — Ensure your CUE file paths are correct and all BIN tracks are present
اجمعها مع: filesystem

Learn PC Engine hardware architecture interactively

👤 Students and enthusiasts learning retro console hardware ⏱ ~45 min advanced

متى تستخدمه: You want to understand the HuC6280 CPU, VDC graphics, and PSG audio systems.

المتطلبات الأساسية
  • Geargrafx with MCP server — Build from source
الخطوات
  1. Explore the VDC
    Step through the VBlank interrupt and explain how the PC Engine's VDC handles background scrolling and sprite rendering.✓ تم النسخ
    → Annotated explanation of VDC register writes and their effects

النتيجة: Hands-on understanding of PC Engine hardware internals.

المزالق
  • SuperGrafx has two VDCs which complicates analysis — Start with regular PC Engine games before tackling SuperGrafx titles

التركيبات

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

geargrafx-2 + filesystem

Export debug data and memory dumps for documentation

Dump the VDC sprite table and tile data to files for analysis.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
pause/resume/step none / step_count? Control emulator execution 0
read_memory address: int, size: int Read emulator memory at any address 0
set_breakpoint address: int Set a CPU breakpoint 0
disassemble address: int, count: int Disassemble HuC6280 instructions 0
get_hardware_status none Get VDC, VCE, and PSG register states 0

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

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

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

الأمان

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

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

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

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

MCP server not responding

Ensure Geargrafx was built with MCP support. Check the default port is available.

تحقق: Test the HTTP endpoint
CD-ROM game won't load

Verify CUE file references correct BIN paths. Try converting to CHD format.

تحقق: Check CUE file contents match actual BIN filenames
SuperGrafx ROM crashes

Only a handful of SuperGrafx games exist. Verify the ROM is actually an SGX title, not a regular PCE ROM.

تحقق: Check ROM header

البدائل

Geargrafx مقابل البدائل

البديلمتى تستخدمهاالمقايضة
GearboyYou want to debug Game Boy ROMs instead of PC EngineDifferent console, same MCP-enabled emulator approach

المزيد

الموارد

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

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

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