概述

一个用于服务器男孩的模型上下文协议（MCP）服务器，允许大型语言模型与GameBoy模拟器交互。 你的LLM可以…

• 载入ROM
• 按键
• 看看Gameboy屏幕
• 跳帧

你可以…

• 使用@modelcontextprotocol/Inspector控制Gameboy模拟器
• 通过网页接口控制Gameboy模拟器（及上传ROM），位于http://localhost:3001/emulator
• 在你喜欢的MCP客户端中安装Gameboy模拟器

特色

• 支持stdio和SSE传输
• 提供GameBoy控制工具（上下、左、右、A、B、开始、选择）
• 提供加载不同ROM的工具
• 提供获取当前屏幕的工具
• 所有工具返回包含最新屏幕帧的ImageContent

安装

通过Smithery安装

通过Smithery自动安装GameBoy模拟器服务器用于Claude Desktop：

安装在FLUJO中

1. 点击添加服务器
2. 复制粘贴Github URL到FLUJO
3. 点击解析、克隆、安装、构建和保存。

手动安装

通过配置文件安装

!!注意：许多MCP客户端要求在.env变量中指定ROM路径为绝对路径

MCP GameBoy Server

Overview

A Model Context Protocol (MCP) server for serverboy, allowing LLMs to interact with a GameBoy emulator. Your LLM can…

• Load ROMS
• Press Keys
• Look at the Gameboy Screen
• skip frames

You can…

• control the gameboy emulator using the @modelcontextprotocol/inspector
• control the gameboy emulator (and upload ROMs) using a web-interface at http://localhost:3001/emulator
• install the gameboy emulator in your favorite MCP-Client

Features

• Supports both stdio and SSE transports
• Provides tools for GameBoy controls (up, down, left, right, A, B, start, select)
• Provides tools to load different ROMs
• Provides tools to get the current screen
• All tools return an ImageContent with the latest screen frame

Installation

Installing via Smithery

To install GameBoy Emulator Server for Claude Desktop automatically via Smithery:

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

Installing in FLUJO

1. Click Add Server
2. Copy & Paste Github URL into FLUJO
3. Click Parse, Clone, Install, Build and Save.

Manual Installation

# 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

Installing via Configuration Files

!! ATTENTION : Many MCP Clients require to specify the ROM-Path in the .env vars as an absolute path

To integrate this MCP server with Cline or other MCP clients via configuration files:

1. Open your Cline settings:

   • In VS Code, go to File -> Preferences -> Settings
   • Search for “Cline MCP Settings”
   • Click “Edit in settings.json”

2. Add the server configuration to the mcpServers object:

   {
     "mcpServers": {
       "mcp-gameboy": {
         "command": "node",
         "args": [
           "/path/to/mcp-gameboy/dist/index.js"
         ],
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

3. Replace /path/to/mcp-gameboy/dist/index.js with the actual path to the index.js file in your project directory. Use forward slashes (/) or double backslashes (\\) for the path on Windows.