MCP GameBoy Server
Servidor MCP GameBoy
Descripción general
Un servidor de Protocolo de Contexto de Modelo (MCP) para serverboy, que permite que los LLM interactúen con un emulador de GameBoy. Tu LLM puede...
Cargar ROMS
Presionar teclas
Mira la pantalla del Gameboy
saltar fotogramas
Puede...
Controla el emulador de Gameboy usando @modelcontextprotocol/inspector
controlar el emulador de Gameboy (y cargar ROM) mediante una interfaz web en http://localhost:3001/emulator
Instala el emulador de Gameboy en tu MCP-Client favorito
Related MCP server: MCP PyBoy Emulator Server
Características
Admite transportes stdio y SSE
Proporciona herramientas para los controles de GameBoy (arriba, abajo, izquierda, derecha, A, B, inicio, seleccionar)
Proporciona herramientas para cargar diferentes ROM
Proporciona herramientas para obtener la pantalla actual.
Todas las herramientas devuelven un ImageContent con el último fotograma de la pantalla
Instalación
Instalación mediante herrería
Para instalar GameBoy Emulator Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @mario-andreschak/mcp-gameboy --client claudeInstalación en FLUJO
Haga clic en Agregar servidor
Copie y pegue la URL de Github en FLUJO
Haga clic en Analizar, Clonar, Instalar, Compilar y Guardar.
Instalación manual
# Clone the repository
git clone https://github.com/yourusername/mcp-gameboy.git
cd mcp-gameboy
# Install dependencies
npm install
# Build the project
npm run buildInstalación mediante archivos de configuración
¡ ATENCIÓN ! Muchos clientes MCP requieren especificar la ruta de la ROM en las variables .env como una ruta absoluta.
Para integrar este servidor MCP con Cline u otros clientes MCP a través de archivos de configuración:
Abra la configuración de Cline:
En VS Code, vaya a Archivo -> Preferencias -> Configuración
Buscar "Configuración de Cline MCP"
Haga clic en "Editar en settings.json".
Agregue la configuración del servidor al objeto
mcpServers:{ "mcpServers": { "mcp-gameboy": { "command": "node", "args": [ "/path/to/mcp-gameboy/dist/index.js" ], "disabled": false, "autoApprove": [] } } }Reemplaza
/path/to/mcp-gameboy/dist/index.jscon la ruta real del archivoindex.jsen el directorio de tu proyecto. Usa barras diagonales (/) o dobles barras diagonales invertidas (\\) para la ruta en Windows.Guarde el archivo de configuración. Cline debería conectarse automáticamente al servidor.
Uso
Variables de entorno
¡ ATENCIÓN ! Muchos clientes MCP requieren especificar la ruta de la ROM en las variables .env como una ruta absoluta.
Cree un archivo .env en el directorio raíz con las siguientes variables:
# Server configuration
PORT=3001
# ROM path for stdio mode
ROM_PATH=./roms/dangan.gbEjecutándose en modo stdio
En el modo estándar, el servidor usa la ruta de la ROM especificada en la variable de entorno ROM_PATH . Abrirá una ventana del navegador para mostrar la pantalla de GameBoy.
npm run startEjecutando en modo SSE
En el modo SSE, el servidor inicia un servidor Express que sirve una página web para la selección de ROM.
npm run start-sseLuego abra su navegador en http://localhost:3001 para seleccionar una ROM.
Herramientas
El servidor proporciona las siguientes herramientas:
press_up: Presiona el botón ARRIBA en el GameBoypress_down: Presiona el botón ABAJO en el GameBoypress_left: Presiona el botón IZQUIERDO en el GameBoypress_right: Presiona el botón DERECHO en el GameBoypress_a: Presiona el botón A en el GameBoypress_b: Presiona el botón B en el GameBoypress_start: Presiona el botón INICIO en el GameBoypress_select: Presiona el botón SELECT en el GameBoyload_rom: Cargar un archivo ROM de GameBoyget_screen: Obtener la pantalla actual de GameBoy
Todas las herramientas devuelven un ImageContent con el último fotograma de pantalla.
Detalles de implementación
Este servidor se creó con el SDK de TypeScript del Protocolo de Contexto de Modelo (MCP). Utiliza:
McpServerde@modelcontextprotocol/sdk/server/mcp.jspara la implementación del servidorStdioServerTransportde@modelcontextprotocol/sdk/server/stdio.jspara el transporte de stdioSSEServerTransportde@modelcontextprotocol/sdk/server/sse.jspara el transporte SSEserverboypara la emulación de GameBoyexpresspara el servidor web en modo SSEcanvaspara renderizar la pantalla de GameBoy
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Available Tools
13 toolsget_screenA
Get the current GameBoy screen (advances one frame)
Inputs: no named parameters.
is_rom_loadedA
Check if a ROM is currently loaded in the emulator
Inputs: no named parameters.
list_romsA
List all available GameBoy ROM files
Inputs: no named parameters.
load_romC
Load a GameBoy ROM file
Inputs: romPath (required).
press_aB
Press the A button on the GameBoy
Inputs: duration_frames.
press_bB
Press the B button on the GameBoy
Inputs: duration_frames.
press_downA
Press the DOWN button on the GameBoy
Inputs: duration_frames.
press_leftA
Press the LEFT button on the GameBoy
Inputs: duration_frames.
press_rightA
Press the RIGHT button on the GameBoy
Inputs: duration_frames.
press_selectB
Press the SELECT button on the GameBoy
Inputs: duration_frames.
press_startA
Press the START button on the GameBoy
Inputs: duration_frames.
press_upB
Press the UP button on the GameBoy
Inputs: duration_frames.
wait_framesC
Wait for a specified number of frames
Inputs: duration_frames.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Every tool has a clearly distinct purpose with no ambiguity. The button press tools are all uniquely named for specific buttons, and the other tools handle distinct emulator operations like screen capture, ROM management, and frame control. There is no overlap in functionality.
All tools follow a consistent verb_noun pattern with snake_case throughout. The naming is perfectly predictable: 'get_screen', 'list_roms', 'load_rom', 'press_a', 'wait_frames', etc. There are no deviations in naming conventions.
13 tools is well-scoped for a GameBoy emulator server. Each tool earns its place with clear purposes: ROM management (3 tools), button controls (8 tools), screen capture (1 tool), and frame control (1 tool). This provides comprehensive coverage without bloat.
The tool surface is nearly complete for GameBoy emulation, covering ROM loading, button inputs, screen capture, and frame control. A minor gap exists in reset/unload functionality, but agents can work around this by reloading ROMs. Core emulator workflows are well-supported.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
A Model Context Protocol server for Wix AI tools
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that allows LLMs to interact with web content through standardized tools, currently supporting web scraping functionality.1MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that allows LLMs to interact with Game Boy games through PyBoy emulation, providing capabilities to load ROMs, control games, capture screens, save/load states, and maintain game knowledge.1MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides LLMs with Pokémon data access and battle simulation capabilities, including an interactive web interface.-
- AlicenseNot gradedqualityDmaintenanceMCP server for the mGBA Game Boy/GBA emulator, enabling full emulator control, memory access, debugging, and screenshot capture through natural language.5MIT