Skip to main content
Glama

MCP 게임보이 서버

대장간 배지

개요

서버보이용 모델 컨텍스트 프로토콜(MCP) 서버로, LLM이 게임보이 에뮬레이터와 상호 작용할 수 있도록 지원합니다. LLM은...

  • ROM 로드

  • 키를 누르세요

  • 게임보이 화면을 보세요

  • 프레임 건너뛰기

당신은 할 수 있습니다...

  • @modelcontextprotocol/inspector를 사용하여 게임보이 에뮬레이터를 제어합니다.

  • http://localhost:3001/emulator 에서 웹 인터페이스를 사용하여 게임보이 에뮬레이터를 제어하고 ROM을 업로드합니다.

  • 좋아하는 MCP-Client에 게임보이 에뮬레이터를 설치하세요

스크린샷 2025-04-25 183528

스크린샷 2025-04-25 081510

영상

Related MCP server: MCP PyBoy Emulator Server

특징

  • stdio와 SSE 전송을 모두 지원합니다

  • GameBoy 컨트롤(위, 아래, 왼쪽, 오른쪽, A, B, 시작, 선택)을 위한 도구를 제공합니다.

  • 다양한 ROM을 로드하기 위한 도구를 제공합니다.

  • 현재 화면을 얻기 위한 도구를 제공합니다

  • 모든 도구는 최신 화면 프레임이 포함된 ImageContent를 반환합니다.

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 GameBoy Emulator Server를 자동으로 설치하려면:

지엑스피1

FLUJO 에 설치하기

  1. 서버 추가를 클릭하세요

  2. Github URL을 복사하여 FLUJO에 붙여넣기

  3. 분석, 복제, 설치, 빌드 및 저장을 클릭합니다.

수동 설치

# 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

구성 파일을 통한 설치

주의 : 많은 MCP 클라이언트는 .env 변수에 ROM 경로를 절대 경로 로 지정해야 합니다.

구성 파일을 통해 이 MCP 서버를 Cline이나 다른 MCP 클라이언트와 통합하려면:

  1. Cline 설정을 엽니다.

    • VS Code에서 파일 -> 환경 설정 -> 설정으로 이동합니다.

    • "Cline MCP 설정"을 검색하세요

    • "settings.json에서 편집"을 클릭하세요.

  2. mcpServers 개체에 서버 구성을 추가합니다.

    {
      "mcpServers": {
        "mcp-gameboy": {
          "command": "node",
          "args": [
            "/path/to/mcp-gameboy/dist/index.js"
          ],
          "disabled": false,
          "autoApprove": []
        }
      }
    }
  3. /path/to/mcp-gameboy/dist/index.js 프로젝트 디렉터리에 있는 index.js 파일의 실제 경로로 바꾸세요. Windows에서는 경로에 슬래시(/) 또는 이중 백슬래시(\\)를 사용하세요.

  4. 설정 파일을 저장하세요. Cline이 자동으로 서버에 연결될 것입니다.

용법

환경 변수

주의 : 많은 MCP 클라이언트는 .env 변수에 ROM 경로를 절대 경로 로 지정해야 합니다.

다음 변수를 사용하여 루트 디렉토리에 .env 파일을 만듭니다.

# Server configuration
PORT=3001

# ROM path for stdio mode
ROM_PATH=./roms/dangan.gb

stdio 모드에서 실행

stdio 모드에서 서버는 ROM_PATH 환경 변수에 지정된 ROM 경로를 사용합니다. 브라우저 창을 열어 GameBoy 화면을 표시합니다.

npm run start

SSE 모드에서 실행

SSE 모드에서는 서버는 ROM 선택을 위한 웹 페이지를 제공하는 Express 서버를 시작합니다.

npm run start-sse

그런 다음 브라우저를 열어 http://localhost:3001 로 접속하여 ROM을 선택하세요.

도구

서버는 다음과 같은 도구를 제공합니다.

  • press_up : 게임보이의 UP 버튼을 누르세요

  • press_down : 게임보이의 DOWN 버튼을 누르세요

  • press_left : 게임보이의 왼쪽 버튼을 누르세요

  • press_right : 게임보이의 오른쪽 버튼을 누르세요

  • press_a : 게임보이의 A 버튼을 누르세요

  • press_b : 게임보이의 B 버튼을 누르세요

  • press_start : 게임보이의 START 버튼을 누르세요

  • press_select : GameBoy의 SELECT 버튼을 누르세요

  • load_rom : GameBoy ROM 파일을 로드합니다

  • get_screen : 현재 GameBoy 화면을 가져옵니다

모든 도구는 최신 화면 프레임이 포함된 ImageContent를 반환합니다.

구현 세부 사항

이 서버는 MCP(Model Context Protocol) TypeScript SDK를 사용하여 구축되었습니다. 다음을 사용합니다.

  • 서버 구현을 위한 @modelcontextprotocol/sdk/server/mcp.js 의 McpServer

  • stdio 전송을 위한 @modelcontextprotocol/sdk/server/stdio.js 의 StdioServerTransport

  • SSE 전송을 위한 @modelcontextprotocol/sdk/server/sse.js 의 SSEServerTransport

  • GameBoy 에뮬레이션을 위한 serverboy

  • SSE 모드에서 웹 서버를 위한 express

  • GameBoy 화면 렌더링을 위한 canvas

특허

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