Godot-MCP10 分钟用对话改 Godot 项目从配置到可玩 Demo 完整实战【免费下载链接】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 接进 Godot 编辑器的对话式游戏开发工具。它解决的核心问题很具体AI 以前只能把代码写在纸上装它之后能直接动你的场景、节点和脚本。适合刚接触 Godot 与 MCP 的新手以及想快速验证游戏想法的独立开发者。 接入只需 3 步配置一次长期可用前置条件Godot 4.x、Node.js 18、已开启 MCP 的 Claude Desktop。第 1 步拉代码构建服务器git clone https://gitcode.com/gh_mirrors/god/Godot-MCP cd Godot-MCP/server npm install npm run build这一步是干什么的把 Godot-MCP 的服务器端编译成dist/index.js这是 Claude 连接 Godot 的入口。第 2 步在 Godot 里启用插件把addons/godot_mcp文件夹复制到你 Godot 项目的addons目录然后在 项目设置 插件 中勾选 Godot MCP。这一步是干什么的插件会在编辑器内起一个 WebSocket 服务器默认端口 9080让 Godot 能听到 AI 的指令。第 3 步把服务器写进 Claude 配置在 Claude Desktop 配置文件里加一条记录仓库里带了 claude_desktop_config.json 可直接参考然后重启 Claude Desktopgodot-mcp: { command: node, args: [你的绝对路径/server/dist/index.js], env: { MCP_TRANSPORT: stdio } }这一步是干什么的告诉 Claude 启动时拉起这个服务器两端自动握手之后不需要再管。 三句对话看懂它能干什么配置完之后你在 Claude 窗口里正常说话就行。三个短示例mcp godot-mcp run get-scene-tree一条命令拿回当前场景树。AI 先看结构再动手不会瞎猜。mcp godot-mcp read godot://script/current 帮我优化这段玩家移动代码并说明改动理由。它能读你当前打开的脚本。建议基于真实代码而不是凭印象。mcp godot-mcp read godot://scene/current 给场景加一个敌人 AI在路径点之间巡逻靠近玩家就攻击。它会自己创建节点、写脚本、挂到场景上。你回 Godot 按 F5 验证。 完整实战用对话搭一个 2D 平台小场景下面用 Godot-MCP 从零走到一个能跑的小场景顺序是场景 → 脚本 → 逻辑 → 收尾。场景开口第一句创建一个 2D 平台场景玩家角色CharacterBody2D、 三块平台、一个可收集的星星、一个显示分数的 Label。它逐个调用建节点工具你能在编辑器里看着节点一个个冒出来。脚本接着说给玩家写一个脚本 res://scripts/player.gd 方向键左右移动空格跳跃带重力。脚本生成后直接挂到玩家节点上立即可跑。逻辑再补一句交互星星被玩家碰到时消失、分数 1、同步更新 Label 文本。碰撞检测、分数变量、UI 刷新它自己串起来。收尾最后一句保存当前场景然后运行项目告诉我运行结果。它调 save-scene 落盘再调 run-project 验证闭环完成。整个过程没离开过对话框。 让 AI 一次做对的 4 个习惯1. 给路径不给形容词反例把主角改快一点。正例把 /root/MainScene/Player 的 move_speed 改成 400。2. 先让 AI 看一眼现状反例上来就说帮我加个敌人系统。正例先跑 get-scene-tree再补一句基于这个结构加敌人。3. 拆步骤别一次梭哈反例做一个完整的主菜单 存档 音效。正例先建主菜单场景放 Play 和 Quit 两个按钮。4. 报现象附上下文反例有 bug。正例按空格不跳。脚本在 res://scripts/player.gd_physics_process 里没收到输入事件。 常用指令速查表指令作用get-scene-tree返回当前场景树结构create-node / modify-node / delete-node增改删节点update-node-property修改节点属性值read-script / create-script / modify-script读取、新建、编辑 GDScriptanalyze-script分析脚本并给出优化建议create-scene / save-scene新建场景 / 保存场景get-project-settings查看项目配置run-project / stop-project运行 / 停止项目完整的参数说明在 docs/command-reference.md上手流程可以看 docs/getting-started.md。⚠️ 三个高频故障的排查路径故障 1Claude 连不上 Godot现象提示 WebSocket 连接失败原因Godot 侧服务器没启动或端口与默认 9080 不一致解决在 Godot 的 MCP 面板点 Start Server确认两端端口一致后重启 Claude Desktop故障 2命令成功场景却没变化现象AI 回复已创建编辑器里看不到新节点原因改动只存在于内存场景没有落盘解决让它调用 save-scene或手动 CtrlS故障 3插件启用了但完全没反应现象MCP 面板不出现控制台有报错原因配置改动后项目未重载或服务器路径写了相对路径解决重启 Godot检查配置文件里是绝对路径且server/dist/index.js真实存在 想改它从这两个入口开始插件核心命令如何落到 Godot API 上addons/godot_mcp/服务器与工具定义怎么注册一个新指令server/src/架构与消息协议docs/architecture.md扩展 Godot-MCP 的路径是固定的在 Godot 侧写一个命令处理器再在服务端的 tools 里注册同名工具对话里就能直接调用。现在就可以做的一件事打开 Godot 启用插件在 Claude 里敲一句运行 get-scene-tree把结果给我。看到真实的节点树回来说明链路通了剩下的交给你正在做的游戏。【免费下载链接】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），仅供参考