Godot-MCP 节点命令详解：create_node 到 list_nodes 的 5 大操作完整参考

Godot-MCP 节点命令详解create_node 到 list_nodes 的 5 大操作完整参考【免费下载链接】Godot-MCPAn MCP for Godot that lets you create and edit games in the Godot game engine with tools like Claude项目地址: https://gitcode.com/gh_mirrors/god/Godot-MCPGodot-MCP 是一款让 Claude 等 AI 助手直接操作 Godot 引擎的 MCP 插件。它通过 WebSocket 双向通信让 AI 能够用自然语言在 Godot 项目中创建场景、编辑脚本和修改节点。本文聚焦其中的 5 大节点命令——从create_node到list_nodes的完整参考帮你快速上手用 AI 管理 Godot 场景树。 快速了解 Godot-MCP 的架构Godot-MCP 由两部分组成组件位置作用Godot 插件Addonaddons/godot_mcp/运行在 Godot 编辑器内接收并执行命令MCP 服务器server/src/桥接 Claude 与 Godot定义 AI 可调用的工具一条命令的完整流程是你对 Claude 说自然语言需求如帮我创建一个按钮节点Claude 通过MCP 服务器发送 WebSocket 命令到 GodotGodot 插件的命令处理器路由到对应的处理器并执行执行结果原路返回你切换回 Godot 编辑器即可看到变化命令路由逻辑可以在 command_handler.gd 中查看它会把命令依次交给节点、脚本、场景、项目、编辑器等各处理器直到某个处理器认领为止。 5 大节点命令一览节点命令由 Godot 侧的 node_commands.gd 实现MCP 工具定义在 node_tools.ts。完整参数说明可参考官方文档 command-reference.md。命令功能关键参数create_node在场景树中创建新节点parent_path、node_type、node_namedelete_node删除场景树中的节点node_pathupdate_node_property修改节点属性值node_path、property、valueget_node_properties读取节点的全部属性node_pathlist_nodes列出父节点的所有子节点parent_path好消息是你不需要记住这些命令名。用自然语言描述需求Claude 会自动选择合适的命令和参数。1️⃣ create_node一句话生成节点告诉 Claude在 UI 节点下创建一个名为 StartButton 的 Button 节点它就会调用create_node。执行逻辑见 node_commands.gd先用ClassDB校验节点类型是否存在避免拼写错误如把Sprite2D写成Spire2D实例化节点、重命名、挂到父节点下自动设置owner保证节点能正确序列化进场景文件成功后返回新节点的完整路径并标记场景为已修改2️⃣ delete_node安全删除节点删除只需提供节点路径例如删除 /root/MainScene/UI/OldButton。实现上有两层保护见 node_commands.gd根节点不可删尝试删除场景根节点会直接报错防止误删整张场景删除后自动调用queue_free()释放节点资源并标记场景为已修改3️⃣ update_node_property支持撤销的属性修改这是 5 个命令中最贴心的一个。除了常规校验节点存在、属性名正确之外还有两个亮点智能类型解析如果你传入字符串Vector2(100, 200)或Color(1, 0, 0)插件会通过 base_command_processor.gd 中的_parse_property_value自动解析成真正的 Godot 类型而不是把字符串硬塞给属性支持 CtrlZ 撤销属性更新会走编辑器的 Undo/Redo 系统见 node_commands.gdAI 改错了也能一键回退这是它与手动改脚本的重要区别4️⃣ get_node_propertiesAI 的眼睛get_node_properties返回节点的所有公开属性自动过滤以_开头的内部属性见 node_commands.gd。它是 AI 理解你项目的关键当你问我的 Player 节点有哪些属性或帮我看下这个 Label 的文本是什么时Claude 先靠它读取信息再决定怎么修改。MCP 侧还会把属性格式化成属性名: 值的清单返回见 node_tools.ts方便 AI 直接引用。5️⃣ list_nodes快速摸清场景结构list_nodes列出指定父节点下的所有子节点每个节点返回名称、类型、路径三项信息见 node_commands.gd。典型用法列出 /root/MainScene/UI 下所有节点。如果 Claude 之前不了解你的场景结构它通常也会先调用这条命令探路然后再执行创建或修改操作。️ 路径规则与常见排错技巧节点命令统一依赖_get_editor_node解析路径见 base_command_processor.gd规则很简单/root指向当前正在编辑的场景根节点不是全局 /root/root/前缀会被自动剥离所以/root/MainScene/Player等价于相对路径MainScene/Player路径必须相对于当前打开的场景跨场景路径无效结合 getting-started.md 的排错章节常见问题及对策现象可能原因对策Node not found路径拼错或节点不在当前场景先用list_nodes确认实际路径Invalid node type节点类型名拼错使用 Godot 官方类名如Node2D、Sprite2D、Label命令无效果未打开场景或插件未启用确保在 Godot MCP 面板启动了 WebSocket 服务修改未保留忘记保存命令只标记已修改仍需手动保存场景✅ 上手建议组合使用 5 大命令实际开发中一条自然语言需求往往会触发多个节点命令的组合。例如对 Claude 说创建一个主菜单场景包含 Play、Options、Quit 三个按钮再把标题 Label 的字体调大。Claude 大概率会按这个顺序协作create_node搭骨架 →list_nodes确认结构 →update_node_property调参数 →get_node_properties复查结果。新手建议从只读命令开始先用list_nodes、get_node_properties熟悉 AI 如何看你的项目小步迭代让 Claude 每次只做一个小改动随时用 CtrlZ 回退善用路径反馈每条命令的成功响应都带节点路径把它反馈给 Claude 可大幅提升后续操作的准确性想深入了解消息协议和设计模式可以阅读 architecture.md想继续探索脚本、场景、项目等其他命令类别command-reference.md 中有完整清单。【免费下载链接】Godot-MCPAn MCP for Godot that lets you create and edit games in the Godot game engine with tools like Claude项目地址: https://gitcode.com/gh_mirrors/god/Godot-MCP创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考