Gameboy Emulator

🚀 MCP 遊戲男孩服務器

MCP 遊戲男孩服務器是一個基於 Model Context Protocol (MCP) 的服務器，專為 serverboy 設計。它能讓大語言模型（LLMs）與 GameBoy 模擬器實現交互，為遊戲模擬和 AI 應用帶來新的可能。

🚀 快速開始

MCP 遊戲男孩服務器允許 LLMs 與 GameBoy 模擬器交互，你的 LLM 可以加載 ROM 文件、按下按鍵、查看遊戲男孩屏幕以及跳過幀。你還能使用 @modelcontextprotocol/inspector 或 web 界面（地址為 http://localhost:3001/emulator）控制遊戲男孩模擬器並上傳 ROM 文件，也可以在你最喜歡的 MCP 客戶端中安裝遊戲男孩模擬器。

✨ 主要特性

• 支持 stdio 和 SSE 傳輸，確保數據傳輸的多樣性和穩定性。
• 提供豐富的遊戲男孩控制工具，包括上、下、左、右、A、B、開始、選擇等按鍵控制。
• 具備加載不同 ROM 文件的工具，可讓你體驗多種遊戲。
• 提供獲取當前屏幕的工具，方便即時查看遊戲畫面。
• 所有工具均返回帶有最新屏幕幀的 ImageContent，保證信息的及時性和準確性。

📦 安裝指南

通過 Smithery 安裝

要自動通過 Smithery 安裝遊戲男孩模擬器服務器以供 Claude Desktop 使用，可執行以下命令：

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

💻 使用示例

基礎用法

服務器提供了一系列實用工具，以下是部分工具的使用示例：

# 按下游戲男孩的 UP 按鍵
press_up

# 加載遊戲男孩 ROM 文件
load_rom

高級用法

你可以根據具體需求組合使用這些工具，實現更復雜的操作。例如，先加載 ROM 文件，然後按下開始按鍵啟動遊戲：

load_rom
press_start

🔧 技術細節

此服務器使用 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 模式下創建網絡服務器。
• canvas 渲染遊戲男孩屏幕。

📄 許可證

本項目採用 MIT 許可證。