gearboy

一款高精度、跨平台的Game Boy/Game Boy Color/Super Game Boy模拟器,内置MCP服务器用于调试和工具集成。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:gearboy。
它的用途是:一款高精度、跨平台的Game Boy/Game Boy Color/Super Game Boy模拟器,内置MCP服务器用于调试和工具集成。
完整的 Skill 内容见:https://321skill.com/skills/gearboy/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“启动 Gearboy 模拟器,加载《塞尔达传说:织梦岛》的 ROM,并在游戏主角生命值内存地址设置一个断点。” 它会通过 MCP 协议调用 Gearboy,启动模拟器并设置调试断点。或者

对AI说:“单步执行十次 CPU 指令,然后告诉我寄存器 A 和程序计数器 PC 的当前值。” 它会控制模拟器执行并返回具体的 CPU 状态信息。

介绍

Gearboy 是一款用 C++ 编写的高精度 Game Boy、Game Boy Color 和 Super Game Boy 模拟器,解决了开发者、游戏爱好者和研究者需要在现代操作系统上运行、调试和分析经典掌机游戏的需求。它原生支持 Windows、macOS、Linux、BSD 等主流平台,并可作为 RetroArch 核心使用,其最大的特色是内置了 MCP (Model Context Protocol) 服务器,允许用户通过 AI 助手或外部工具直接与模拟器交互,进行内存查看、断点调试、状态保存等高级操作。

对于游戏开发者、逆向工程爱好者或计算机科学教育者来说,Gearboy 是一个强大的工具。他们可以利用其精确的模拟和调试功能来研究经典游戏的运行机制、开发自制游戏(Homebrew)或进行硬件仿真相关的教学演示。

使用 Gearboy 时,建议先从其 GitHub Releases 页面下载对应平台的桌面版本,或通过 Homebrew、PPA 等包管理器安装。对于希望集成到自动化工作流或通过 AI 进行交互的用户,需要重点关注其 MCP 功能,并参考相关的 MCP 文档进行配置。

需要注意的是,Gearboy 是一个模拟器软件,用户需自行准备合法的游戏 ROM 文件。其主要价值在于提供精准的模拟和强大的调试能力,而非游戏资源本身。

核心特点

与其他模拟器相比,Gearboy 的核心区别在于其原生集成了 MCP 服务器,使得开发者能够通过 Claude、Cursor 等支持 MCP 的 AI 助手直接进行内存调试、执行控制等深度操作,将模拟器调试无缝融入现代 AI 辅助开发工作流。

注意事项

该 Skill 主要面向开发和调试场景,不适合仅寻求简单游戏体验的普通玩家。

常见问题

Gearboy 支持哪些游戏平台?

支持 Game Boy (GB)、Game Boy Color (GBC) 以及 Super Game Boy (SGB) 的精确模拟。

如何利用 AI 助手调试 Game Boy 游戏?

通过其内置的 MCP 服务器,在配置了 MCP 客户端的 AI 助手(如 Claude Desktop)中,可以直接发送指令来查看内存、设置断点、控制游戏执行等。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/gearboy/raw/index.md 读取 gearboy 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。