# Gearsystem MCP Server

> Gearsystem MCP Server is an open-source MCP server for developer tools. Sega Master System, Game Gear and SG-1000 emulator with an embedded MCP debugging server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, CLI
- **Repository:** https://github.com/drhelius/gearsystem
- **MCP Registry name:** io.github.drhelius/gearsystem
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/gearsystem-mcp-server
