MCP ゲームボーイ サーバー

概要

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

• ROMをロードする

• キーを押す

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

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

あなたはできる...

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

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

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

特徴

• stdioとSSEトランスポートの両方をサポート

• GameBoy のコントロール用のツールを提供します (上、下、左、右、A、B、スタート、選択)

• さまざまなROMをロードするためのツールを提供します

• 現在の画面を取得するためのツールを提供します

• すべてのツールは最新のスクリーンフレームを含むImageContentを返します

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の GameBoy Emulator Server を自動的にインストールするには:

FLUJOへのインストール

1. サーバーの追加をクリック

2. Github URL をコピーして FLUJO に貼り付けます

3. 「解析」、「複製」、「インストール」、「ビルド」、「保存」をクリックします。

手動インストール

設定ファイルによるインストール

!!注意: 多くの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ファイルをルート ディレクトリに作成します。

stdioモードで実行

stdioモードでは、サーバーはROM_PATH環境変数で指定されたROMパスを使用します。ブラウザウィンドウが開き、ゲームボーイの画面が表示されます。

SSEモードで実行

SSE モードでは、サーバーは ROM 選択用の Web ページを提供する Express サーバーを起動します。

次に、ブラウザで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

ライセンス

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