Geartowns MCP Server

What Geartowns MCP Server MCP server does

Geartowns MCP Server MCP server lets an AI assistant interact with the Geartowns Fujitsu FM Towns emulator during debugging and development. The emulator is written in C++ and runs as a standalone application on Windows, macOS, Linux, and BSD, with additional RetroArch support. The MCP functionality is embedded in the emulator rather than presented as a separate service in the supplied documentation.

The integration is intended for AI-assisted examination of FM Towns programs. It exposes emulator-oriented operations, including control over execution, memory inspection, hardware-status checks, and rewind. The README also refers to additional debugging functions without listing every tool or its exact interface.

How it works

Geartowns runs the FM Towns emulation environment and provides an MCP endpoint for compatible AI clients. An assistant can use the exposed debugging operations while the emulator is running, allowing investigation from the emulator’s execution and hardware state rather than from a general-purpose development environment.

The underlying emulator includes a broad debugger with a just-in-time disassembler, execution, data, I/O, and interrupt breakpoints; code navigation; call-stack inspection; symbols; labels; memory editing; tracing; profiling; and i386 register, descriptor-table, and paging views. It also includes inspectors for devices and subsystems such as the CRTC, palettes, framebuffers, sprites, audio chips, CD-ROM, floppy hardware, interrupts, timers, DMA, the RTC, keyboard, and game ports. The README does not establish that every graphical debugger view is exposed as an MCP tool.

Setup and configuration

Download a Geartowns build for the target platform, or use the available MCPB package listed by the project. The supplied material does not provide the MCP client configuration format, command, transport details, or individual tool schemas, so those settings should be checked in the project’s MCP documentation before installation.

Geartowns requires FM Towns firmware files to boot: FMT_SYS.ROM, FMT_DOS.ROM, FMT_FNT.ROM, and FMT_DIC.ROM. FMT_F20.ROM is optional. In the desktop emulator, select the firmware directory through Machine → Firmware → Choose BIOS Directory.... Media can be provided as CD-ROM or floppy images, including supported playlist and compressed-image formats.

Tools and capabilities

Geartowns MCP Server MCP server is documented as exposing tools for:

• Controlling emulator execution
• Inspecting memory
• Reading hardware status
• Rewinding emulation
• Performing additional AI-assisted debugging tasks

The emulator itself supports save states, rewind, screenshots, video recording, CD-ROM and floppy emulation, and several debugging inspectors. These are emulator capabilities; the excerpt does not confirm which are available through MCP.

Limitations and notes

Only FM Towns Model 1/2 and Custom machine configurations are currently identified as supported. Firmware and usable game media are prerequisites for meaningful emulator sessions. Windows may require the Visual C++ Redistributable and OpenGL Compatibility Pack; Linux may require libsdl3.

The README names GitHub Copilot, Claude, and Codex as examples of AI clients for the MCP debugging feature, but it does not document client-specific setup. It also does not list environment variables, exact MCP tool names, authentication options, or a detailed protocol configuration. Geartowns MCP Server MCP server is therefore best evaluated alongside the repository’s separate MCP documentation before deployment.