SuperAPI AI 工具集

mcp-scene-builder

编程与开发

查看项目

更新于 10-16 22:42

技能介绍

MCP Scene Builder 是一个高层智能体接口,封装了底层的 Godot MCP 工具,用来从零开始构建 Godot 场景。它本身不是独立编辑器,而是一套指导智能体如何正确调用 MCP 工具、按阶段完成场景搭建的技能规范。

用途 该技能用于把「创建一个场景」「制作一个角色」「搭建一个关卡」这类自然语言请求,转换为一系列有序的 MCP 工具调用,从而生成或修改 Godot 的 .tscn 场景文件。

主要能力与强制规则 技能列出多条必须遵守的约束,用于避免常见错误:

  • 不得跳过设计阶段:不能直接调用 mcp_godot_add_node 而不先规划层级,否则会得到「意大利面式」的场景;应先草拟节点树。
  • 不得假设场景已存在:对不存在的场景调用 mcp_godot_add_node 会报错;必须先行调用 mcp_godot_create_scene。
  • 不得在 MCP 调用中使用绝对路径:如 texturePath="C:/Users/..." 在其他机器上会失效,只能使用 res:// 路径。
  • 不得跳过验证步骤:MCP 会创建 .tscn 文件但不会做校验,应始终调用 mcp_godot_run_project 或 mcp_godot_launch_editor 确认没有错误。
  • 不得在未设置 shape 的情况下添加 CollisionShape2D:MCP 会添加该节点,但其 shape 属性默认为空,必须手动设置,否则场景是有问题的。

脚本 scene_builder_manifest.gd:通过 MCP 进行声明式场景构建的资源定义。

可用的 MCP 工具摘要

  • mcp_godot_create_scene:初始化一个 .tscn 文件。
  • mcp_godot_add_node:向已存在的场景添加节点。
  • mcp_godot_load_sprite:为 Sprite2D 节点指定纹理。
  • mcp_godot_run_project:启动 Godot 编辑器以验证结果。

工作流:构建一个场景 当收到「创建一个场景」「制作一个角色」或「搭建一个关卡」的请求时,按以下阶段执行:

  1. 设计阶段:确定根节点类型(例如 CharacterBody2D、Node3D、Control),草拟节点层级(例如 Root -> Sprite2D、CollisionShape2D)。
  2. 执行阶段(MCP 流水线):第 1 步调用 mcp_godot_create_scene 创建文件;第 2 步依次为每个子节点调用 mcp_godot_add_node;第 3 步(可选)若需要精灵图,调用 mcp_godot_load_sprite;第 4 步(验证关键)调用 mcp_godot_run_project 或 mcp_godot_launch_editor。
  3. 优化阶段:在附加脚本时应用 gdscript-mastery 标准。

示例:创建一个基础 2D 玩家 提示词:「创建一个带精灵和碰撞的 2D 玩家场景。」 计划:

  • mcp_godot_create_scene(scenePath="player.tscn", rootNodeType="CharacterBody2D")
  • mcp_godot_add_node(scenePath="player.tscn", nodeType="Sprite2D", nodeName="Skin", parentNodePath=".")
  • mcp_godot_add_node(scenePath="player.tscn", nodeType="CollisionShape2D", nodeName="Hitbox", parentNodePath=".")
  • mcp_godot_load_sprite(scenePath="player.tscn", nodePath="Skin", texturePath="res://icon.svg")

验证 智能体必须验证场景能在编辑器中打开且没有错误。

适用场景与限制 适用于使用 Godot 引擎、并已具备相应 MCP 工具环境的场景创建与修改任务。其限制在于:MCP 自身不会校验生成的场景,需要额外验证步骤;涉及碰撞形状时必须手动补全 shape 属性;路径必须为 res:// 形式。关于收费、价格、支持的 Godot 版本范围等信息,资料暂未提供。