Geargrafx MCP Server
by drheliuscommunityv1.7.4
201
11
Geargrafx is a cross-platform emulator for TurboGrafx-16, PC Engine, SuperGrafx, and PCE CD-ROM², featuring an embedded MCP server for debugging and tooling.
From the registry: MCP server for Geargrafx PC Engine / TurboGrafx-16 emulator
Install & configure
Prerequisites
- requiredInstall Geargrafx emulatorDownload Geargrafx binary for your platformhttps://github.com/drhelius/Geargrafx/releases
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `geargrafx` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Geargrafx emulator** — Download Geargrafx binary for your platform (https://github.com/drhelius/Geargrafx/releases)
Canonical MCP server config (stdio transport):
- command: `geargrafx`
- args: ["--mcp-stdio","--headless"]
Note: MCP server is embedded in the Geargrafx TurboGrafx-16/PC Engine emulator binary. Launch with --mcp-stdio for stdio transport.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: MCP server is embedded in the Geargrafx TurboGrafx-16/PC Engine emulator binary. Launch with --mcp-stdio for stdio transport.
Environment variables
MCP_HTTP_PORTHTTP port for MCP server (default: 7777)Packages
https://github.com/drhelius/geargrafx/releases/download/1.7.4/Geargrafx-1.7.4-mcpb-macos-arm64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/geargrafx/releases/download/1.7.4/Geargrafx-1.7.4-mcpb-macos-x64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/geargrafx/releases/download/1.7.4/Geargrafx-1.7.4-mcpb-windows-arm64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/geargrafx/releases/download/1.7.4/Geargrafx-1.7.4-mcpb-windows-x64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/geargrafx/releases/download/1.7.4/Geargrafx-1.7.4-mcpb-linux-x64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/geargrafx/releases/download/1.7.4/Geargrafx-1.7.4-mcpb-linux-arm64.mcpb
mcpbtransport: stdio
Details
- Language
- C++
- License
- GPL-3.0
- Released
- Mar 30, 2026
- Last commit