Gearboy MCP Server
by drheliuscommunityv3.8.2
1.1k
152
Gearboy is a cross-platform emulator for Game Boy, Game Boy Color, and Super Game Boy, featuring an embedded MCP server for debugging and tooling.
From the registry: MCP server for Gearboy Nintendo Game Boy / Game Boy Color emulator
Install & configure
Prerequisites
- requiredInstall Gearboy emulatorDownload Gearboy binary for your platform (Windows, macOS, Linux, BSD)https://github.com/drhelius/Gearboy/releases
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `gearboy` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Gearboy emulator** — Download Gearboy binary for your platform (Windows, macOS, Linux, BSD) (https://github.com/drhelius/Gearboy/releases)
Canonical MCP server config (stdio transport):
- command: `gearboy`
- args: ["--mcp-stdio","--headless"]
Note: MCP server is embedded in the Gearboy Game Boy emulator binary. Launch with --mcp-stdio for stdio transport or --mcp-http for HTTP. Also supports --headless mode.
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 Gearboy Game Boy emulator binary. Launch with --mcp-stdio for stdio transport or --mcp-http for HTTP. Also supports --headless mode.
Environment variables
MCP_HTTP_PORTrequiredHTTP port for MCP server (default: 7777)Packages
https://github.com/drhelius/gearboy/releases/download/3.8.2/Gearboy-3.8.2-mcpb-macos-arm64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/gearboy/releases/download/3.8.2/Gearboy-3.8.2-mcpb-macos-x64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/gearboy/releases/download/3.8.2/Gearboy-3.8.2-mcpb-windows-arm64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/gearboy/releases/download/3.8.2/Gearboy-3.8.2-mcpb-windows-x64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/gearboy/releases/download/3.8.2/Gearboy-3.8.2-mcpb-linux-x64.mcpb
mcpbtransport: stdio
https://github.com/drhelius/gearboy/releases/download/3.8.2/Gearboy-3.8.2-mcpb-linux-arm64.mcpb
mcpbtransport: stdio
Details
- Language
- C++
- License
- GPL-3.0
- Released
- Apr 1, 2026
- Last commit
- Apr 11, 2026