MCP GameBoy Server
MCP ゲームボーイ サーバー
概要
serverboy用のモデルコンテキストプロトコル(MCP)サーバー。LLMがGameBoyエミュレータと連携できるようにします。LLMは…
ROMをロードする
キーを押す
ゲームボーイの画面を見てください
フレームをスキップする
あなたはできる...
@modelcontextprotocol/inspector を使用してゲームボーイ エミュレータを制御する
http://localhost:3001/emulator のWeb インターフェースを使用してゲームボーイ エミュレーターを制御し (ROM をアップロードします)
お気に入りのMCPクライアントにゲームボーイエミュレーターをインストールします
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 claudeFLUJOへのインストール
サーバーの追加をクリック
Github URL をコピーして FLUJO に貼り付けます
「解析」、「複製」、「インストール」、「ビルド」、「保存」をクリックします。
手動インストール
# 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 クライアントと統合するには、次の手順を実行します。
Cline 設定を開きます:
VS Codeで、「ファイル」->「設定」->「設定」に移動します。
「Cline MCP 設定」を検索
「settings.jsonで編集」をクリック
mcpServersオブジェクトにサーバー構成を追加します。{ "mcpServers": { "mcp-gameboy": { "command": "node", "args": [ "/path/to/mcp-gameboy/dist/index.js" ], "disabled": false, "autoApprove": [] } } }/path/to/mcp-gameboy/dist/index.js、プロジェクトディレクトリ内のindex.jsファイルへの実際のパスに置き換えてください。Windows の場合は、パスにスラッシュ (/) または二重のバックスラッシュ (\\) を使用してください。設定ファイルを保存します。Cline は自動的にサーバーに接続します。
使用法
環境変数
!!注意: 多くのMCPクライアントでは、.env変数のROMパスを絶対パスとして指定する必要があります。
次の変数を含む.envファイルをルート ディレクトリに作成します。
# Server configuration
PORT=3001
# ROM path for stdio mode
ROM_PATH=./roms/dangan.gbstdioモードで実行
stdioモードでは、サーバーはROM_PATH環境変数で指定されたROMパスを使用します。ブラウザウィンドウが開き、ゲームボーイの画面が表示されます。
npm run startSSEモードで実行
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のMcpServerstdio トランスポート用の
@modelcontextprotocol/sdk/server/stdio.jsからのStdioServerTransportSSE トランスポート用の
@modelcontextprotocol/sdk/server/sse.jsからのSSEServerTransportゲームボーイエミュレーション用の
serverboySSEモードのWebサーバー用の
expressゲームボーイ画面をレンダリングするための
canvas
ライセンス
マサチューセッツ工科大学
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.
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