Godot-MCP 完整指南：用 AI 对话开发 Godot 游戏，从安装到跑通的最小路径

Godot-MCP 完整指南用 AI 对话开发 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 接入 Godot 引擎的开源项目让 AI 游戏开发从敲代码变成说需求你告诉它要什么场景、什么功能它在编辑器里替你建节点、改脚本。这篇教程带你装好它并跑通第一个由 AI 生成的场景。先看看它跑起来的样子这一节先让你有个预期装好之后日常工作是什么节奏。Godot-MCP 由两部分组成Godot 编辑器里的一个插件和一个用 Node.js 写的 MCP 服务器MCP 是一种让 AI 调用外部工具的标准协议这里负责在 Claude 和 Godot 之间来回翻译。工作时你在 Claude 的对话框里打字插件收到指令后调用 Godot 引擎的接口去执行节点和脚本直接出现在编辑器里。Godot 左侧的 Godot MCP 面板会显示连接状态和日志出问题时先看它。装好它只需要几步这一节帮你走最短路径拉代码、装依赖、编译然后两边各配一处。git clone https://gitcode.com/gh_mirrors/god/Godot-MCP cd Godot-MCP/server npm install npm run buildclone把源码拉到本地卡住多为网络问题换个网络或时段重试。npm install给 MCP 服务器装依赖报错先看 Node.js 是否 18 以上网络慢就临时换 npm 镜像。npm run build把 TypeScript 编译成 server/dist/index.js这是 Claude 要启动的入口报错先确认依赖装全。然后配置两端Claude 这一端打开 Claude Desktop 的配置文件macOS 在~/Library/Application Support/Claude/claude_desktop_config.json按仓库自带的 claude_desktop_config.json 示例加一段把 args 里的路径换成你 server/dist/index.js 的绝对路径重启 Claude Desktop。卡住先看路径是不是绝对路径、文件是否真实存在。Godot 这一端直接用 Godot 导入克隆下来的仓库project.godot 在根目录示例项目里插件已经启用。要接到自己的项目把 addons/godot_mcp 文件夹拷进你项目的 addons 目录再到 项目设置 插件 里启用 Godot MCP。它能替你干哪几件事这一节用三个日常场景说明它能干什么你对照自己的活看哪部分值得交给它。搭场景一句话生成 2D 平台场景你对 AI 说建一个 2D 平台游戏场景玩家角色KinematicBody2D、几个当地面的平台、几个可收集的星星它会先调 create-scene 建场景再连续调 create-node 把节点一个个放好你随时可以用 get-scene-tree 核对当前结构。Godot 编辑器里会直接出现这棵节点树不用你手动拖。改脚本让 AI 读 GDScript 并加功能先让它读再让它改。读一下 res://scripts/player.gd给玩家加上平滑的左右移动和跳跃——它用 read-script 拿到现有代码说明准备怎么改你确认后通过 modify-script 写回并挂到节点上。改动较大时让它先给方案再动手改完再读一遍核对。查 bug把现象描述给 AI 定位问题不贴代码说现象就行敌人 AI 有时会卡在角落分析一下 enemy_ai.gd。它调 analyze-script 检查逻辑指出可疑点并给出具体改法需要查项目配置时还能用 get-project-settings 把相关设置拉出来对照。全部命令和参数都写在 命令参考 里用哪个查哪个。5 分钟最小实战这一节带你走一遍最短闭环一句需求进去一个能动的场景出来。前提是 Godot 里已打开示例项目面板显示已连接。对 Claude 说建一个 2D 场景一个玩家KinematicBody2D、一个地面平台StaticBody2D、三颗星星Area2D。你会看到场景树里节点逐个出现2D 视口里摆出布局。接着说给玩家写一个简单的移动脚本左右箭头键控制挂到玩家节点上。你会看到 res:// 下多出一个 .gd 文件并自动挂到玩家节点。最后说保存场景并运行项目。你会看到编辑器保存 .tscn游戏窗口弹出玩家左右移动。容易翻车的 4 个地方这 4 条按现象、原因、解法排好了遇到就照着查。Claude 里找不到 godot-mcp 工具多半是配置路径不是绝对路径把 args 换成 server/dist/index.js 的绝对路径重启 Claude Desktop。Claude 回复连不上 Godot插件没启用或启用后没重新加载项目到 项目设置 插件 启用 Godot MCP再重载项目。create-node 报错、节点没建出来父节点路径写错或不存在先用 get-scene-tree 看真实结构再给正确路径。配置都对却一直连接超时插件固定监听 9080 端口旧实例占着端口关掉旧的编辑器进程确认端口空闲后重试。想继续深入仓库里的 架构文档 讲清楚了 Claude、MCP 服务器、Godot 插件三者之间怎么通信入门指南 适合边做边查想读源码的话插件核心在 addons/godot_mcp/服务器在 server/src/。下一步建议从给现有项目加一个小功能开始比如让 AI 给主菜单加个开始按钮跑顺了再让它搭完整场景。【免费下载链接】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），仅供参考