MCP GameBoy Server

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

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

To install GameBoy Emulator Server for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install @mario-andreschak/mcp-gameboy --client claude

# Clone the repository git clone https://github.com/yourusername/mcp-gameboy.git cd mcp-gameboy # Install dependencies npm install # Build the project npm run build

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

Replace/path/to/mcp-gameboy/dist/index.jswith the actual path to theindex.jsfile in your project directory. Use forward slashes (/) or double backslashes (\\) for the path on Windows.

Save the settings file. Cline should automatically connect to the server.

!!ATTENTION: Many MCP Clients require to specify the ROM-Path in the .env vars as anabsolute path

Create a.envfile in the root directory with the following variables:

# Server configuration PORT=3001 # ROM path for stdio mode ROM_PATH=./roms/dangan.gb

In stdio mode, the server uses the ROM path specified in theROM_PATHenvironment variable. It will open a browser window to display the GameBoy screen.

In SSE mode, the server starts an Express server that serves a web page for ROM selection.

Then open your browser tohttp://localhost:3001to select a ROM.

The server provides the following tools:

- press_up: Press the UP button on the GameBoy
- press_down: Press the DOWN button on the GameBoy
- press_left: Press the LEFT button on the GameBoy
- press_right: Press the RIGHT button on the GameBoy
- press_a: Press the A button on the GameBoy
- press_b: Press the B button on the GameBoy
- press_start: Press the START button on the GameBoy
- press_select: Press the SELECT button on the GameBoy
- load_rom: Load a GameBoy ROM file
- get_screen: Get the current GameBoy screen

All tools return an ImageContent with the latest screen frame.

This server is built using the Model Context Protocol (MCP) TypeScript SDK. It uses:

- McpServerfrom@modelcontextprotocol/sdk/server/mcp.jsfor the server implementation
- StdioServerTransportfrom@modelcontextprotocol/sdk/server/stdio.jsfor stdio transport
- SSEServerTransportfrom@modelcontextprotocol/sdk/server/sse.jsfor SSE transport
- serverboyfor the GameBoy emulation
- expressfor the web server in SSE mode
- canvasfor rendering the GameBoy screen

Live AI agent city-economy on Base L2 — 92 NPC agents earn real USDC via jobs, trading, and businesses across 10 cities. Claim jobs for USDC payouts, chat with agents, check AGWC token data, and get live crypto news. 11 tools, no API key.

40 MCP tools for AI agents to play a yield-generating pet game on Base chain. Earn USDC/ETH/BTC by raising virtual pets. Impact: every action burns tokens and retires carbon credits.

Connect to UCI-compatible chess engines like Stockfish to play and analyze games. Requires a local chess engine binary.

An MCP server for '海龟汤' (Turtle Soup), a scenario-based reasoning puzzle game.

Play a legendary text adventure by talking to your AI — no commands to memorize. The Hidden Empire puts a full underground world of puzzles, treasures, and trolls inside your conversation. Speak naturally: say 'head north,' 'grab the lantern,' or 'what am I carrying?' and your AI handles the rest. Execute multi-move plans in one shot, undo mistakes instantly, and save up to 20 named playthroughs you can resume from any session. Based on the MIT-licensed Zork I source, rebuilt from the ground up for AI-native play.

Rolls dice using standard notation (e.g., 1d20) and returns individual rolls and their sum.

Provides access to information about free games on the Epic Games Store.

An AI-powered, synthwave, maze-crawling, and world-building adventure game server.

Provides access to Marvel Rivals game data through a standardized interface.

Control a Minecraft character to build, explore, and interact with the game world using natural language.