drhelius/Gearsystem

Sega Master System / Game Gear / SG-1000 emulator, debugger and embedded MCP server for macOS, Windows, Linux, BSD and RetroArch.

What it solves

Gearsystem is a high-accuracy emulator for Sega Master System, Game Gear, and SG-1000 consoles. It allows users to play classic games from these systems on modern platforms like Windows, macOS, Linux, and RetroArch. It also provides professional-grade debugging tools for developers and ROM hackers who need to inspect the internal state of the hardware emulation.

How it works

Written in C++, the project emulates the Z80 CPU, VDP (Video Display Processor), PSG, and FM sound chips. It supports a wide variety of cartridge types and regions (NTSC-JAP, NTSC-USA, PAL-EUR) and includes an internal database for ROM detection. For advanced users, it integrates a Model Context Protocol (MCP) server, which allows AI agents (such as Claude or GitHub Copilot) to interact with the emulator's execution control, memory, and hardware status for AI-assisted debugging.

Who it’s for

  • Gamers: People who want to play Sega's 8-bit era games with high accuracy.
  • Developers/ROM Hackers: Those performing reverse engineering, cheat creation, or game patching who need a full debugger and AI-assisted tooling.

Highlights

  • AI-Assisted Debugging: Integrated MCP server and Agent Skills for AI agents to help with code tracing and ROM hacking.
  • ** wysokie Accuracy**: High-fidelity emulation of Z80, VDP, and sound chips.
  • Comprehensive Debugger: Includes a JIT disassembler, CPU/memory breakpoints, and VRAM viewer.
  • Cross-Platform: Runs on a vast array of platforms including desktop OSs, Android, iOS, and various consoles via Libretro.
  • Quality of Life: Features like run-ahead to reduce input lag, save states with rewind, and compressed ROM support.

Related

  • Project
  • Project
  • Project
  • Project
  • Project