用途:作为 Godot 低层 MCP 工具的高层代理接口,用程序化方式从零创建或修改 Godot 场景,适合“创建场景”“做一个角色”“搭建关卡”等任务。
主要能力:提供声明式场景构建资源定义 scene_builder_manifest.gd,并封装以下 MCP 工具:mcp_godot_create_scene 初始化 .tscn 文件;mcp_godot_add_node 向已有场景添加节点;mcp_godot_load_sprite 为 Sprite2D 节点指定纹理;mcp_godot_run_project 启动 Godot 编辑器验证结果。
使用方式(流程):1)设计阶段先确定根节点类型(如 CharacterBody2D、Node3D、Control),并草拟节点层级;2)执行阶段先调用 mcp_godot_create_scene 创建文件,再按顺序对每个子节点调用 mcp_godot_add_node,如需贴图则调用 mcp_godot_load_sprite,最后调用 mcp_godot_run_project 或 mcp_godot_launch_editor 验证;3)优化阶段按 gdscript-mastery 标准挂载脚本。
示例要点:创建 2D 玩家场景时,调用 mcp_godot_create_scene(scenePath="player.tscn", rootNodeType="CharacterBody2D"),再添加 Sprite2D 与 CollisionShape2D 节点,并用 res://icon.svg 设置纹理。
限制与注意事项:不要跳过设计阶段;添加节点前必须先用 mcp_godot_create_scene 创建场景;只能使用 res:// 路径,禁止绝对路径;MCP 创建 .tscn 后不会做校验,必须运行项目或启动编辑器验证;添加 CollisionShape2D 时必须手动设置 shape 属性,否则场景会损坏。