Godot-MCP 完全指南让 Claude 用对话直接改 Godot 场景【免费下载链接】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 Desktop 接入 Godot 编辑器的 MCP 集成MCP 即 Model Context ProtocolAI 助手调用外部工具的标准接口。启用插件并注册服务器后你可以用自然语言创建节点、编写 GDScript、管理场景不必再在聊天框和编辑器之间来回复制粘贴。还在编辑器里逐个点属性吗用 Godot 做游戏重复劳动很多建节点、填属性、写样板脚本、核对场景树。你把需求描述给 Claude它多半只回你一段文字还得自己粘进编辑器。Godot-MCP 补的就是这段它由 Godot 端插件addons/godot_mcp加载进编辑器的扩展模块和一个 Node.js 服务器server/组成Claude 的指令会直接在编辑器里执行结果再读回来。你只需要备好三样东西Godot 4.x、Node.js 18 以上、支持 MCP 的 Claude Desktop。如何完成最小配置并用第一条指令验证安装并构建服务器git clone https://gitcode.com/gh_mirrors/god/Godot-MCP cd Godot-MCP/server npm install npm run build构建完成后得到server/dist/index.js这是 Claude 稍后要调用的入口。在 Claude Desktop 注册打开 Claude Desktop 的配置文件claude_desktop_config.jsonmacOS 在~/Library/Application Support/Claude/下仓库根目录有一份现成示例可参照加入这一段{ mcpServers: { godot-mcp: { command: node, args: [/你的绝对路径/Godot-MCP/server/dist/index.js], env: { MCP_TRANSPORT: stdio } } } }注意args里必须是绝对路径换克隆位置就要同步修改。保存后重启 Claude Desktop。在 Godot 启用插件把仓库的addons/godot_mcp文件夹复制到你项目的addons/目录项目 项目设置 插件启用 Godot MCP编辑器右侧会出现 Godot MCP Server 面板第一条指令在 Godot 里打开项目面板上点 Start Server。默认端口 9080Claude 端的服务器会通过ws://localhost:9080连进来。然后在 Claude Desktop 里问mcp godot-mcp run get-scene-tree 当前场景里有哪些节点能返回节点结构链路就通了。执行中 Claude 可能对部分操作征求你的确认点允许即可。它能做哪些编辑器操作场景、脚本、项目能力分三组。你不必背命令名描述目标后 Claude 会自己选用但知道它们方便你核对场景与节点create-scene新建场景save-scene保存read-scene读结构create-node、modify-node、delete-node操作节点get-scene-tree、get-node-properties只读。脚本create-script新建 GDScript 并可同时挂到节点modify-script改现有文件read-script读取analyze-script做代码体检list-project-scripts列出项目全部脚本。项目与编辑器get-project-settings读配置list-project-resources列资源run-project、stop-project一键运行与停止get-editor-state查看编辑器状态。另有三个只读端点godot://script/current当前打开的脚本、godot://scene/current当前场景、godot://project/info项目信息。 端到端走查对话搭一个 3D 检查点房间用一个全新的 3D 小场景串一遍四段对话依次进行新建一个 3D 场景根节点 Node3D存到 res://scenes/checkpoint_room.tscn。 → 对应create-scene根节点下加一个大 PlaneMesh 地面在 (0, 0.5, 5) 放一个名为 checkpoint 的 BoxMesh原点放一个名为 player 的 CharacterBody3D。 → 多次create-node加modify-node写 res://scripts/room.gdWASD 移动 player靠近 checkpoint 时打印提示完成后保存场景。 →create-script加save-scene运行项目十秒后停止有报错就告诉我。 →run-project加stop-project在 Godot 里按 F5 可以复核效果。发现检查点位置不对只要补一句把 checkpoint 移到 (0, 0.5, 8)Claude 会调modify-node修正不用重写整个请求。不工作时怎么处理三个常见现象Claude 报连不上 Godot多为插件没启用或面板里没点 Start Server也可能是端口不一致默认 9080确认面板与服务器两侧同值再重启 Claude Desktop。命令执行报错多为路径或属性名写错。先让它get-scene-tree核对真实路径再下发文件路径以res://开头且必须真实存在。编辑器里看不到变化常见于场景没保存。让 Claude 执行save-scene或在 Godot 里手动保存仍不行就看 Godot 控制台和面板日志里的报错。源码、文档与扩展点插件源码在addons/godot_mcp/commands/子目录按节点、脚本、场景、项目分类新增命令在这里注册服务器实现在server/src/工具定义位于tools/子目录命令参考每条命令的参数说明入门指南 与 安装指南更细的步骤架构文档Claude、服务器、Godot 三方的消息流程想扩展时路径是清晰的插件里加一个命令处理器服务器里注册一个对应工具Claude 就多一项新能力。【免费下载链接】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），仅供参考