Skip to main content
Glama

Servidor MCP GameBoy

insignia de herrería

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

Captura de pantalla 2025-04-25 183528

Captura de pantalla 2025-04-25 081510

imagen

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 claude

Instalación en FLUJO

  1. Haga clic en Agregar servidor

  2. Copie y pegue la URL de Github en FLUJO

  3. 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 build

Instalació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:

  1. 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".

  2. 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": []
        }
      }
    }
  3. Reemplaza /path/to/mcp-gameboy/dist/index.js con la ruta real del archivo index.js en el directorio de tu proyecto. Usa barras diagonales (/) o dobles barras diagonales invertidas (\\) para la ruta en Windows.

  4. 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.gb

Ejecutá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 start

Ejecutando 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-sse

Luego 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 GameBoy

  • press_down : Presiona el botón ABAJO en el GameBoy

  • press_left : Presiona el botón IZQUIERDO en el GameBoy

  • press_right : Presiona el botón DERECHO en el GameBoy

  • press_a : Presiona el botón A en el GameBoy

  • press_b : Presiona el botón B en el GameBoy

  • press_start : Presiona el botón INICIO en el GameBoy

  • press_select : Presiona el botón SELECT en el GameBoy

  • load_rom : Cargar un archivo ROM de GameBoy

  • get_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:

  • McpServer de @modelcontextprotocol/sdk/server/mcp.js para la implementación del servidor

  • StdioServerTransport de @modelcontextprotocol/sdk/server/stdio.js para el transporte de stdio

  • SSEServerTransport de @modelcontextprotocol/sdk/server/sse.js para el transporte SSE

  • serverboy para la emulación de GameBoy

  • express para el servidor web en modo SSE

  • canvas para renderizar la pantalla de GameBoy

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

13 tools
get_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

    A3.7/5.0

    Scored across 13 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the mGBA Game Boy/GBA emulator, enabling full emulator control, memory access, debugging, and screenshot capture through natural language.
      5
      MIT