Skip to content
MCP server

Gearsystem MCP Server

Sega Master System, Game Gear and SG-1000 emulator with an embedded MCP debugging server

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Windows, macOS, Linux
Runs
Locally
Version
3.9.25
Listing updated
today

Similar MCP servers

About Gearsystem MCP Server

Gearsystem MCP Server is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Gearsystem covers the Sega Mark III, Master System, Game Gear, SG-1000 and Othello Multivision, and ships with an MCP server so Claude Code, Codex and similar clients can debug a running game. The README describes tools for execution control, memory inspection, hardware status and rewind but gives no individual tool names.

The emulator models the Z80, VDP, PSG and the YM2413 FM sound chip, detects region automatically and has an internal ROM database. It handles many cartridge types including Codemasters, Korean and MSX mappers, supports Light Phaser and Paddle controllers, and offers link-cable emulation between two local desktop instances (Gear-to-Gear and Mark III Joy-Joy). Cheats work with Game Genie and Pro Action Replay codes, and RetroArch .cht files can be imported.

For developers there is a full debugger with symbol loading for sjasmplus, Pasmo, SDCC/NoICE, wla-dx and vasm formats. It runs on Windows, macOS, Linux and BSD, plus RetroArch across many more platforms, and is distributed with MCPB bundles.

Install

Run in a terminal

claude mcp add gearsystem -- npx -y https://github.com/drhelius/gearsystem/releases/download/3.9.25/Gearsystem-3.9.25-mcpb-macos-arm64.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gearsystem": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/drhelius/gearsystem/releases/download/3.9.25/Gearsystem-3.9.25-mcpb-macos-arm64.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gearsystem": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/drhelius/gearsystem/releases/download/3.9.25/Gearsystem-3.9.25-mcpb-macos-arm64.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gearsystem": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/drhelius/gearsystem/releases/download/3.9.25/Gearsystem-3.9.25-mcpb-macos-arm64.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gearsystem": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/drhelius/gearsystem/releases/download/3.9.25/Gearsystem-3.9.25-mcpb-macos-arm64.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gearsystem": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/drhelius/gearsystem/releases/download/3.9.25/Gearsystem-3.9.25-mcpb-macos-arm64.mcpb"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Embedded MCP server
AI clients can control execution and inspect memory and hardware.
Multi-machine support
Covers Mark III, Master System, Game Gear, SG-1000 and Othello Multivision.
FM sound
Emulates the YM2413 FM chip alongside PSG.
Link cable emulation
Connects two local instances over Gear-to-Gear or Mark III Joy-Joy.
Symbol-aware debugger
Loads sjasmplus, Pasmo, SDCC, wla-dx and vasm symbols.
Cheats and states
Game Genie, Pro Action Replay, save states and rewind.

Good for

  • Debug Master System homebrew with an AI assistant
  • Inspect sprites and tiles in the VRAM viewer
  • Test Game Gear link-cable play across two instances
  • Load symbol files from an SDCC project while stepping code
  • Play SG-1000 and Master System games with cheats

Pricing

Open source

Free and open source; sponsorship optional

Gearsystem MCP Server FAQ

Which systems are emulated?

Sega Mark III, Master System, Game Gear, SG-1000 and Othello Multivision.

Is a BIOS required?

No, it can run with or without one.

Which symbol formats load?

sjasmplus/Pasmo EQU, SDCC/NoICE, wla-dx and vasm or generic files.

Can I run it without a GUI?

The README for the sister emulators mentions headless mode; for Gearsystem check its command-line options.

Is Gearsystem MCP Server free?

Yes. Gearsystem MCP Server is open source, so you can use and self-host it for free.

How do I add Gearsystem MCP Server to Claude Code?

Run this command in your terminal: claude mcp add gearsystem -- npx -y https://github.com/drhelius/gearsystem/releases/download/3.9.25/Gearsystem-3.9.25-mcpb-macos-arm64.mcpb

What are the best alternatives to Gearsystem MCP Server?

The closest alternatives to Gearsystem MCP Server are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers