Gameboy Emulator

🚀 MCP ゲームボーイサーバ

Model Context Protocol (MCP) を使用したサーバで、serverboy を通じて LLMs が GameBoy エミュレータとやり取りできるようにします。LLM は ROM ファイルの読み込みやゲームボーイの操作、画面の確認などが可能です。

🚀 クイックスタート

このサーバは Model Context Protocol (MCP) を用いて、LLMs が GameBoy エミュレータとやり取りできるようにするものです。LLM は以下の操作が可能です。

• ROM ファイルの読み込み
• ゲームボーイのボタン操作
• ゲームボーイの画面確認
• フレームのスキップ

また、ユーザーは以下の方法でゲームボーイエミュレータを操作できます。

• @modelcontextprotocol/inspector を使用して操作
• web インターフェース（http://localhost:3001/emulator）を使用して操作し、ROM ファイルをアップロード
• 好きな MCP クライアントにゲームボーイエミュレータをインストール

✨ 主な機能

• stdio と SSE の通信方式をサポート
• ゲームボーイの操作ツール（上、下、左、右、A、B、開始、選択）を提供
• 異なる ROM ファイルを読み込むツールを提供
• 現在の画面を取得するツールを提供
• すべてのツールは最新の画面フレームを含む ImageContent を返す

📦 インストール

Smithery を通じたインストール

Claude Desktop で使用するために、Smithery を通じて自動的にゲームボーイエミュレータサーバをインストールするには、以下のコマンドを実行します。

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

FLUJO でのインストール

1. 「サーバーを追加」をクリック
2. GitHub のリンクをコピーして FLUJO に貼り付ける
3. 解析、クローン、インストール、ビルド、保存をクリック

手動インストール

npm install --save @modelcontextprotocol/sdk serverboy express canvas

💻 使用例

基本的な使用法

サーバーが提供するツールを使用することで、ゲームボーイの操作や ROM ファイルの読み込みが可能です。

# 例: 上ボタンを押す
press_up

高度な使用法

複数の操作を組み合わせることで、より高度なゲームプレイが可能です。

# 例: ROM ファイルを読み込んで、上ボタンを押す
load_rom "example.rom"
press_up

📚 ドキュメント

サーバーは以下のツールを提供します。

• press_up：ゲームボーイの上ボタンを押す
• press_down：ゲームボーイの下ボタンを押す
• press_left：ゲームボーイの左ボタンを押す
• press_right：ゲームボーイの右ボタンを押す
• press_a：ゲームボーイの A ボタンを押す
• press_b：ゲームボーイの B ボタンを押す
• press_start：ゲームボーイの開始ボタンを押す
• press_select：ゲームボーイの選択ボタンを押す
• load_rom：ゲームボーイの ROM ファイルを読み込む
• get_screen：現在のゲームボーイの画面を取得する

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

🔧 技術詳細

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

• McpServer （@modelcontextprotocol/sdk/server/mcp.js）：サーバーの実装
• StdioServerTransport （@modelcontextprotocol/sdk/server/stdio.js）：stdio 通信
• SSEServerTransport （@modelcontextprotocol/sdk/server/sse.js）：SSE 通信
• serverboy：ゲームボーイのエミュレーション
• express：SSE モードでの Web サーバーの作成
• canvas：ゲームボーイの画面のレンダリング

📄 ライセンス

MIT