gbstudio mcp
 ](https://nodejs.org/) 
用简单的英语描述一个Game Boy游戏。得到一个可玩的 .gbsproj 文件。
一 主控程序 为AI助手（Claude等）提供创建和编辑能力的服务器 西安仙童工作室 项目。通过对话构建Game Boy游戏——场景、演员、脚本事件、变量、触发器——所有这些都来自自然语言。
为什么？
GB Studio是制作Game Boy游戏的绝佳工具，但手动设置场景、连接脚本和管理项目JSON是乏味的。这个MCP服务器可以让你跳过样板：描述你想要什么，人工智能会为你构建项目结构。在GB Studio中打开结果以添加像素艺术，然后点击构建。
先决条件
- Node.js 18+
- 西安仙童工作室 已安装(下载)--用于开放和建设项目
- 兼容MCP的AI客户端（Claude Desktop、OpenClaw等）
安装
git clone https://github.com/gmcdonald44/gbstudio-mcp.git
cd gbstudio-mcp
npm install
npm run build设置
克劳德桌面版
添加到您的 claude_desktop_config.json:
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"gbstudio": {
"command": "node",
"args": ["/absolute/path/to/gbstudio-mcp/dist/index.js"]
}
}
}重新启动克劳德桌面。24gbstudio工具将出现在🔌 工具面板。
📖 包含故障排除的完整设置指南： docs/claude-desktop-setup.md
其他MCP客户端
适用于任何兼容MCP的客户端——Cursor、Zed、OpenClaw或您自己的客户端。使用与绝对路径相同的配置格式 dist/index.js.
工具
项目管理
| 工具 | 说明 |
|---|---|
create_project | 创建新 .gbsproj 存在合理的违约 |
open_project | 将现有项目加载到内存中 |
save_project | 将内存中的项目写入磁盘 |
get_project_info | 获取项目统计数据（场景数、演员等） |
场景
| 工具 | 说明 |
|---|---|
list_scenes | 列出项目中的所有场景 |
add_scene | 创建新场景 |
get_scene | 获取特定场景的详细信息 |
update_scene | 修改场景属性 |
delete_scene | 删除场景 |
演员
| 工具 | 说明 |
|---|---|
list_actors | 列出场景中的演员 |
add_actor | 在场景中安排一个新演员 |
update_actor | 修改参与者属性 |
delete_actor | 删除演员 |
触发器
| 工具 | 说明 |
|---|---|
list_triggers | 列出场景中的触发器 |
add_trigger | 在场景中添加触发区域 |
update_trigger | 修改触发器属性 |
delete_trigger | 移除触发器 |
脚本编写
| 工具 | 说明 |
|---|---|
add_script_event | 添加脚本事件（对话、场景切换、条件等） |
get_script | 查看实体上的当前脚本 |
clear_script | 从脚本中删除所有事件 |
变量
| 工具 | 说明 |
|---|---|
add_variable | 创建新的游戏变量 |
list_variables | 列出所有变量 |
delete_variable | 删除变量 |
构建
| 工具 | 说明 |
|---|---|
build_rom | 建立一个 .gb 通过GB Studio CLI访问ROM |
示例提示
"Build me a Game Boy RPG with 3 scenes and a shopkeeper"
"Add a new forest scene with two NPCs who give you a quest"
"Create a trigger at (5, 10) that teleports the player to the dungeon"
"Add dialogue to the shopkeeper that checks if the player has the key"
"Wire up a conditional: if hasSword is true, the guard lets you pass"📚 两个桶中有12个提示 --精灵艺术家、开发人员、说书人、教育工作者、游戏干扰者等： 提示/
演练：构建一个简单的RPG
以下是当你要求人工智能构建游戏时，幕后会发生什么：
create_project--创建MyRPG.gbsproj具有默认背景和精灵add_scene×3--创造“小镇”、“森林”和“地牢”场景add_actor--将店主NPC置于城镇场景中add_script_event--添加对话： *“欢迎！买把剑？”*add_variable--创建一个hasSword变量add_trigger--在城镇场景中添加门触发器add_script_event--将触发器连接到EVENT_SCENE_SWITCH→ 森林save_project--将所有内容写入磁盘
打开 .gbsproj 在GB Studio中，插入像素图片，然后点击 构建ROM!
建筑
Client (Claude, OpenClaw, etc.)
│
│ MCP Protocol (JSON-RPC 2.0 over stdio)
▼
Tool Router (src/index.ts)
│
▼
In-Memory Project State (src/project.ts)
│
│ save_project / open_project
▼
.gbsproj file on disk服务器将项目保存在内存中。您可以创建或打开一个项目，使用各种工具进行更改，然后保存。这 .gbsproj 该文件是标准的GBStudioJSON，和GBStudio编辑器完全兼容。
注： 背景和精灵资源被创建为存根。在GB Studio中添加实际的PNG文件。这 build_rom 工具需要 gb-studio-cli --如果没有它，请在GB Studio中打开项目进行构建。
文档
- Claude桌面设置 --连接到Claude Desktop，验证工具，排除故障
- 入门指南 --安装、配置、构建您的第一款游戏
- 工具参考 --所有20个工具及其参数和示例
- GB工作室格式 —
.gbsproj文件结构参考 - 脚本事件 --EVENT\_\*命令、模式和示例
- 建筑 --内部，如何添加工具，贡献
- 提示示例 --两个桶中有12个提示（有艺术/没有艺术）
已知限制
- 资产档案 （PNG精灵/背景）仍必须在GB Studio中手动添加
- ROM编译 需要GB Studio CLI或桌面应用程序
- 内存状态重置 当服务器重新启动时--使用
save_project频繁地 - 无多人游戏/网络 支持（是Game Boy！）
- 无碰撞编辑器 --使用GB Studio的可视化编辑器处理碰撞图块
- 无法撤消 --检查
get_scene/get_script在破坏性变化之前
贡献
欢迎投稿！看 贡献.md 作为指导方针。
许可证
麻省理工学院 ©格兰特·麦克唐纳