Geargrafx, developed by Drhelius, is a PC Engine / TurboGrafx-16 / SuperGrafx / PCE CD-ROM² emulator. Built primarily with C++, it uniquely integrates an embedded Model Context Protocol (MCP) server. This design allows it to connect with various AI agents and clients, extending its utility beyond traditional emulation. Geargrafx supports diverse platforms through zipped binaries, package managers like Homebrew, and as a Libretro core. It also offers .mcpb bundles for direct integration with MCP clients, making it a versatile tool for retro gaming and AI-assisted development.

What does Geargrafx connect to?

Geargrafx functions as an MCP server, enabling connections to external AI agents and clients. This integration allows the emulator to communicate with various AI systems, including GitHub Copilot, Claude, Codex, and ChatGPT. The program’s core category is an MCP server, which is embedded within its game emulator for PC Engine, TurboGrafx-16, SuperGrafx, and PCE CD-ROM² systems. It supports STDIO and HTTP transport protocols, with STDIO being the preferred method for establishing these AI connections.

Core features and tools

The embedded MCP server exposes specific callable tools for interaction. These include execution control, memory inspection, breakpoints, disassembly, hardware status, and rewind. Beyond these, Geargrafx provides specialized Agent Skills: geargrafx-debugging and geargrafx-romhacking. These skills enable AI agents to perform advanced functions directly within the emulator environment, offering a deeper level of interaction for development and analysis tasks.

Who is it for?

Geargrafx targets a specialized audience, including individuals involved in AI debugging and development, homebrew development, ROM hacking, and reverse engineering for PC Engine / TurboGrafx-16 / SuperGrafx / PCE CD-ROM² systems. It also serves those diagnosing complex game behavior. The program's design caters to users who require AI assistance for intricate tasks within retro gaming environments. Skip this if you are solely seeking a basic emulator without any interest in AI integration or advanced development features.

How to get started

No credentials are required for accessing the MCP server. Setup involves running Geargrafx with command-line arguments such as "--mcp-stdio" or "--mcp-http" to automatically start the MCP server, with STDIO being the preferred transport protocol.

Use cases

• Game debugging: Includes code tracing, breakpoint management, hardware inspection, and reverse engineering with AI assistance.
• ROM hacking: Encompasses cheat creation, memory searching, ROM data modification, text translation, and game patching, also with AI assistance.
• AI-assisted development: Allows AI agents full read/write access to the emulator state and complete control of the built-in debugger.

Geargrafx offers a unique blend of retro game emulation and AI agent integration, powered by its embedded MCP server. It provides powerful tools for debugging, ROM hacking, and AI-assisted development across several classic platforms. This makes it an important resource for specialized developers and enthusiasts.