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 许可证。