MCP Gameboy MCP Server

A gameboy emulator for LLM's

Local serverstdioTypeScript

What is the MCP Gameboy MCP Server?

MCP Gameboy connects MCP Gameboy to AI assistants that speak the Model Context Protocol. A gameboy emulator for LLM's.

What MCP Gameboy does

You can... - control the gameboy emulator using the @modelcontextprotocol/inspector - control the gameboy emulator (and upload ROMs) using a web-interface at http://localhost:3001/emulator - install the gameboy emulator in your favorite MCP-Client

A Model Context Protocol (MCP) server for serverboy, allowing LLMs to interact with a GameBoy emulator. Your LLM can... - Load ROMS - Press Keys - Look at the Gameboy Screen - skip frames

Key capabilities

  • Supports both stdio and SSE transports
  • Provides tools for GameBoy controls (up, down, left, right, A, B, start, select)
  • Provides tools to load different ROMs
  • Provides tools to get the current screen
  • All tools return an ImageContent with the latest screen frame

Practical notes

  • Maintained by mario-andreschak, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
press_upPress the UP button on the GameBoy
press_downPress the DOWN button on the GameBoy
press_leftPress the LEFT button on the GameBoy
press_rightPress the RIGHT button on the GameBoy
press_aPress the A button on the GameBoy
press_bPress the B button on the GameBoy
press_startPress the START button on the GameBoy
press_selectPress the SELECT button on the GameBoy
load_romLoad a GameBoy ROM file
get_screenGet the current GameBoy screen

How to install the MCP Gameboy MCP Server

{
  "mcpServers": {
    "mcp-gameboy": {
      "command": "node",
      "args": [
        "/path/to/mcp-gameboy/dist/index.js"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use MCP Gameboy to press up.”
  • “Use MCP Gameboy to press down.”
  • “Use MCP Gameboy to press left.”

Frequently asked questions

A gameboy emulator for LLM's Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.