# Geartowns MCP Server [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/drhelius/geartowns  
**GitHub Stars:** 11  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/geartowns-mcp-server

## Description
MCP server for the Geartowns FM Towns emulator

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

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

## Setup and configuration

Download a Geartowns build for the target platform, or use the available MCPB package listed by the project.

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.

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

_Full upstream README: https://allmcps.com/mcp/geartowns-mcp-server/readme_