Skip to main content
Glama

MCP ゲームボーイ サーバー

鍛冶屋のバッジ

概要

serverboy用のモデルコンテキストプロトコル(MCP)サーバー。LLMがGameBoyエミュレータと連携できるようにします。LLMは…

  • ROMをロードする

  • キーを押す

  • ゲームボーイの画面を見てください

  • フレームをスキップする

あなたはできる...

  • @modelcontextprotocol/inspector を使用してゲームボーイ エミュレータを制御する

  • http://localhost:3001/emulator のWeb インターフェースを使用してゲームボーイ エミュレーターを制御し (ROM をアップロードします)

  • お気に入りのMCPクライアントにゲームボーイエミュレーターをインストールします

スクリーンショット 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 を自動的にインストールするには:

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

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パスを使用します。ブラウザウィンドウが開き、ゲームボーイの画面が表示されます。

npm run start

SSEモードで実行

SSE モードでは、サーバーは ROM 選択用の Web ページを提供する 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 : ゲームボーイのスタートボタンを押します

  • press_select : ゲームボーイのSELECTボタンを押す

  • load_rom : GameBoy ROMファイルをロードする

  • get_screen : 現在のゲームボーイ画面を取得する

すべてのツールは、最新の画面フレームを含む ImageContent を返します。

実装の詳細

このサーバーは、Model Context Protocol (MCP) TypeScript SDKを使用して構築されています。以下のものを使用しています。

  • サーバー実装用の@modelcontextprotocol/sdk/server/mcp.jsのMcpServer

  • stdio トランスポート用の@modelcontextprotocol/sdk/server/stdio.jsからのStdioServerTransport

  • SSE トランスポート用の@modelcontextprotocol/sdk/server/sse.jsからのSSEServerTransport

  • ゲームボーイエミュレーション用のserverboy

  • SSEモードのWebサーバー用のexpress

  • ゲームボーイ画面をレンダリングするためのcanvas

ライセンス

マサチューセッツ工科大学

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.

    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