Geartowns MCP Server — Claude Code MCP server: install and use
Connects Geartowns to an AI agent for emulator debugging, including execution control, memory inspection, and hardware status checks.
Open on GitHubWhat Geartowns MCP Server does
Geartowns MCP Server is embedded in the Geartowns emulator and exposes debugging tools to Claude Code, Codex, and other MCP clients. An agent can control execution, inspect memory and hardware state, use rewind, and work with the emulator’s debugger.
Geartowns is a C++ Fujitsu FM Towns emulator for Windows, macOS, Linux, and BSD. Its debugger includes a disassembler, breakpoints, call-stack views, register inspection, and peripheral viewers. The server is tied to Geartowns, so it is meant for emulator debugging rather than general project analysis.
Connection steps are provided in MCP_README.md. Other listed MCP clients include Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed.
What it helps with
- control emulator execution from an AI agent
- inspect memory and hardware state
- trace code with debugger breakpoints
- review FM Towns registers and peripherals
- rewind the emulator after a failure
Example prompts for the agent
- Connect to Geartowns and inspect the hardware state while it runs.
- Set a breakpoint and explain the memory changes around it.
- Rewind the emulator and compare its state before and after the failure.
How to install Geartowns MCP Server
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Geartowns MCP Server
How do I install Geartowns MCP Server in Claude Code?
Open MCP_README.md in the Geartowns repository and follow the MCP server connection steps described there.
What does Geartowns MCP Server do?
It exposes Geartowns debugging tools to an AI agent, including execution control, memory inspection, hardware status, and rewind.
Which clients work with Geartowns MCP Server?
The server is listed for Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed.
