Geargrafx MCP — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Eingebetteter MCP-Server für KI-gestütztes Debugging über Standard- oder HTTP-Transport
Full debugger: JIT disassembler, CPU/memory breakpoints, code navigation
Supports HuCard, SuperGrafx, and CD-ROM² formats (pce, sgx, cue, zip, chd)
Multi Tap support for up to 5 players with various controller types
VGM-Aufzeichnung und Speicherung von Zuständen mit Vorschaubildern

Live-Demo

In der Praxis

geargrafx-2.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/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"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Geargrafx

So debuggen Sie ein PC Engine ROM mit KI-Unterstützung mithilfe von Geargrafx

👤 PC Engine-Homebrew-Entwickler und Retro-Spieleforscher ⏱ ~30 min intermediate

Wann einsetzen: Sie entwickeln oder analysieren ein PC Engine ROM und müssen das Laufzeitverhalten debuggen.

Voraussetzungen

Geargrafx wurde mit MCP-Unterstützung erstellt — Erstellen Sie aus dem Quellcode und folgen Sie dabei der GitHub-README-Datei
Eine PC Engine-ROM-Datei (.pce oder .sgx) — Ihr eigenes Homebrew-ROM oder ein ROM, das Sie rechtmäßig besitzen

Ablauf

Anschließen und prüfen

Stellen Sie eine Verbindung zum Geargrafx MCP-Server her. Zeigen Sie mir den aktuellen HuC6280-CPU-Status und die Demontage am Programmschalter.✓ Kopiert

→ CPU-Register und zerlegte Anweisungen
Analysieren Sie das Sprite-System

Überprüfen Sie die VDC-Sprite-Tabelle. Wie viele Sprites sind aktiv und auf welche Kacheln verweisen sie?✓ Kopiert

→ Sprite-Attributtabelle mit Positionen, Kachelindizes und Flags

Ergebnis: Verständnis der ROM-Ausführung und des VDC-Hardwarestatus zum Debuggen.

Fallstricke

CD-ROM-Spiele erfordern eine ordnungsgemäße CUE/BIN-Einrichtung — Stellen Sie sicher, dass Ihre CUE-Dateipfade korrekt sind und alle BIN-Spuren vorhanden sind

Kombinieren mit: filesystem

Lernen Sie interaktiv die PC Engine-Hardwarearchitektur kennen

👤 Studenten und Enthusiasten lernen Retro-Konsolenhardware ⏱ ~45 min advanced

Wann einsetzen: Sie möchten die HuC6280-CPU, die VDC-Grafik und die PSG-Audiosysteme verstehen.

Voraussetzungen

Geargrafx mit MCP-Server — Aus dem Quellcode erstellen

Ablauf

Entdecken Sie das VDC

Gehen Sie den VBlank-Interrupt durch und erklären Sie, wie das VDC der PC Engine das Scrollen im Hintergrund und das Sprite-Rendering handhabt.✓ Kopiert

→ Kommentierte Erläuterung der VDC-Registerschreibvorgänge und ihrer Auswirkungen

Ergebnis: Praktisches Verständnis der Hardware-Interna von PC Engine.

Fallstricke

SuperGrafx verfügt über zwei VDCs, was die Analyse erschwert — Beginnen Sie mit regulären PC Engine-Spielen, bevor Sie sich mit SuperGrafx-Titeln befassen

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

geargrafx-2 + filesystem

Exportieren Sie Debug-Daten und Speicherauszüge zur Dokumentation

Speichern Sie die VDC-Sprite-Tabelle und die Kacheldaten zur Analyse in Dateien.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen
pause/resume/step	none / step_count?	Steuern Sie die Ausführung des Emulators
read_memory	address: int, size: int	Emulatorspeicher an einer beliebigen Adresse lesen
set_breakpoint	address: int	Legen Sie einen CPU-Haltepunkt fest
disassemble	address: int, count: int	Anweisungen zum Zerlegen des HuC6280
get_hardware_status	none	Rufen Sie die Registerzustände VDC, VCE und PSG ab

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: N/A – vollständig lokal
Tokens pro Aufruf: 100–500 Token pro Debug-Befehl
Kosten in €: Kostenlos und Open Source (MIT-Lizenz)
Tipp: Verwenden Sie gezielte Lesevorgänge anstelle von vollständigen Speicherauszügen.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: N / A

Datenabfluss: Vollständig lokal – keine Netzwerkanrufe

Fehlerbehebung

Häufige Fehler und Lösungen

MCP server not responding

Stellen Sie sicher, dass Geargrafx mit MCP-Unterstützung erstellt wurde. Überprüfen Sie, ob der Standardport verfügbar ist.

Prüfen: Test the HTTP endpoint

CD-ROM game won't load

Überprüfen Sie, ob die CUE-Dateiverweise auf die richtigen BIN-Pfade verweisen. Versuchen Sie, in das CHD-Format zu konvertieren.

Prüfen: Check CUE file contents match actual BIN filenames

SuperGrafx ROM crashes

Es gibt nur eine Handvoll SuperGrafx-Spiele. Stellen Sie sicher, dass es sich bei dem ROM tatsächlich um einen SGX-Titel und nicht um ein normales PCE-ROM handelt.

Prüfen: Check ROM header

Alternativen

Geargrafx vs. andere

Alternative	Wann stattdessen	Kompromiss
Gearboy	Sie möchten Game Boy-ROMs anstelle der PC Engine debuggen	Andere Konsole, gleicher MCP-fähiger Emulator-Ansatz

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen