PolarHub
  • Agents
  • MCP Servers
  • Skills
  • PolarBear
PolarHub © 2026
MCP Serversgames-and-gamificationGameBoy连接器
返回「games-and-gamification」

GameBoy连接器

modelscope·@mario-andreschak/mcp-gameboy

games-and-gamification0下载LocalModelScope

简介

一种模型上下文协议服务器,使大型语言模型能够与GameBoy模拟器交互,提供控制GameBoy、加载ROM以及检索屏幕帧的工具。

MCP Server 详情

来自 ModelScope 索引

MCP GameBoy 服务器

smithery 徽章

<a href="https://glama.ai/mcp/servers/@mario-andreschak/mcp-gameboy"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@mario-andreschak/mcp-gameboy/badge" alt="GameBoy 服务器 MCP 服务器" /> </a>

概述

这是一个用于 serverboy 的模型上下文协议 (MCP) 服务器,允许大型语言模型 (LLMs) 与 GameBoy 模拟器进行交互。 您的 LLM 可以...

  • 加载 ROM
  • 按键
  • 查看 GameBoy 屏幕
  • 跳过帧

您可以...

  • 使用 @modelcontextprotocol/inspector 控制 GameBoy 模拟器
  • 通过 http://localhost:3001/emulator 网页界面控制 GameBoy 模拟器(并上传 ROM)
  • 在您喜欢的 MCP 客户端中安装 GameBoy 模拟器

截图 2025-04-25 183528

截图 2025-04-25 081510

图片

功能

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

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 GameBoy 模拟器服务器:

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

在 FLUJO 中安装

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

手动安装

bash

克隆仓库

git clone https://github.com/yourusername/mcp-gameboy.git cd mcp-gameboy

安装依赖

npm install

构建项目

npm run build

通过配置文件安装

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

要通过配置文件将此 MCP 服务器与 Cline 或其他 MCP 客户端集成:

  1. 打开您的 Cline 设置:

    • 在 VS Code 中,转到文件 -> 首选项 -> 设置
    • 搜索 "Cline MCP 设置"
    • 点击 "在 settings.json 中编辑"
  2. 将服务器配置添加到 mcpServers 对象中: json { "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 文件,并添加以下变量:

服务器配置

PORT=3001

stdio 模式下的 ROM 路径

ROM_PATH=./roms/dangan.gb

以 stdio 模式运行

在 stdio 模式下,服务器使用 ROM_PATH 环境变量中指定的 ROM 路径。它将打开一个浏览器窗口来显示 GameBoy 屏幕。

bash npm run start

以 SSE 模式运行

在 SSE 模式下,服务器启动一个 Express 服务器,提供一个网页用于选择 ROM。

bash npm run start-sse

然后在浏览器中打开 http://localhost:3001 选择 ROM。

工具

服务器提供了以下工具:

  • press_up: 按下 GameBoy 上的方向键
  • press_down: 按下 GameBoy 下的方向键- press_left: 按下 GameBoy 上的 LEFT 按钮
  • press_right: 按下 GameBoy 上的 RIGHT 按钮
  • press_a: 按下 GameBoy 上的 A 按钮
  • press_b: 按下 GameBoy 上的 B 按钮
  • press_start: 按下 GameBoy 上的 START 按钮
  • press_select: 按下 GameBoy 上的 SELECT 按钮
  • load_rom: 加载一个 GameBoy ROM 文件
  • get_screen: 获取当前 GameBoy 屏幕

所有工具都返回带有最新屏幕帧的 ImageContent。

实现细节

该服务器使用 Model Context Protocol (MCP) TypeScript SDK 构建。它使用了:

  • 从 @modelcontextprotocol/sdk/server/mcp.js 导入的 McpServer 用于服务器实现
  • 从 @modelcontextprotocol/sdk/server/stdio.js 导入的 StdioServerTransport 用于 stdio 传输
  • 从 @modelcontextprotocol/sdk/server/sse.js 导入的 SSEServerTransport 用于 SSE 传输
  • serverboy 用于 GameBoy 模拟
  • express 用于在 SSE 模式下的 Web 服务器
  • canvas 用于渲染 GameBoy 屏幕

许可证

MIT

相关 MCP Servers(来自「games-and-gamification」)

mcpet伙伴

一种怀旧的虚拟宠物体验,适合人工智能时代,让你可以领养、养育并与自己的数字伙伴玩耍,该伙伴会根据你的照顾而进化。

@shreyaskarnik/mcpet

模型棋盘棋

一个服务器,允许用户与任何大语言模型对弈国际象棋,具有可视化棋盘、用标准符号进行走子以及从PGN文件分析局面的功能。

@jiayao/mcp-chess

mcsm-mcp

暂无描述。

@SMGoro/mcsm-mcp

minecraft-bedrock-education-mcp

暂无描述。

@Mming-Lab/minecraft-bedrock-education-mcp

RandomWeb3MCP 随机生成器

RandomWeb3MCP 是基于 EVM 区块哈希的随机元素生成服务。该服务提供了多种随机元素生成工具,可应用于游戏、金融、测试等领域。

@suxiongye/random-web3-mcp

runescape-wiki-mcp

暂无描述。

@birdwell/runescape-wiki-mcp

自动安装

点击按钮会唤起 PolarBear 客户端,并把当前 MCP Server 的 Markdown 详情文档地址传给客户端。

/api/mcps/mario-andreschak-mcp-gameboy/markdown
打开 PolarBear 安装查看 Markdown 文档

手动安装

在 PolarBear 或其他支持 MCP 的客户端中,新建 MCP Server,并参考下方来源或安装提示配置。

暂未识别到安装命令,请打开 ModelScope 详情查看完整配置。

基本信息

分类
games-and-gamification / agent-orchestration
运行方式
No
许可证
MIT License
详情文件
mario-andreschak-mcp-gameboy.md