4步将 Godot-MCP 插件集成到 Godot 项目：从复制 addons 到启用插件的完整指南

4步将 Godot-MCP 插件集成到 Godot 项目从复制 addons 到启用插件的完整指南【免费下载链接】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 插件是一款基于模型上下文协议MCP的 Godot 编辑器插件它让 Claude 等 AI 助手可以直接操作你的 Godot 项目——创建节点、编写 GDScript、管理场景。本教程将带你从零开始完成 Godot MCP 插件的安装与启用只需 4 个简单步骤。一、认识 Godot-MCP 插件它能做什么Godot-MCP 插件在 Godot 编辑器内部启动一个 WebSocket 服务器默认端口 9080作为 AI 与编辑器之间的桥梁。启用后它提供五大类能力命令类别能做什么 节点命令创建、修改、删除场景树中的节点 脚本命令读取、创建、编辑 GDScript 文件️ 场景命令打开、保存、重建场景结构⚙️ 项目命令获取项目设置与资源列表️ 编辑器命令运行项目、查看编辑器状态插件的核心入口是 addons/godot_mcp/mcp_server.gd它负责在编辑器启动时监听端口并接收 AI 发来的指令。二、快速了解插件文件结构在动手之前先花 30 秒了解你要复制的内容。Godot-MCP 的插件部分全部位于addons/godot_mcp/目录addons/godot_mcp/ ├── plugin.cfg # 插件配置名称、版本、入口脚本 ├── mcp_server.gd # 主插件 WebSocket 服务器 ├── command_handler.gd # 命令路由与执行 ├── commands/ # 各类命令实现 ├── ui/ # MCP 控制面板 └── utils/ # 节点/脚本/资源工具函数其中 plugin.cfg 声明了插件名称 Godot MCP 和入口脚本mcp_server.gdGodot 正是靠它识别这个插件。三、集成四步法核心步骤第 1 步获取 Godot-MCP 仓库打开终端克隆仓库到本地git clone https://gitcode.com/gh_mirrors/god/Godot-MCP cd Godot-MCP 如果你已经通过仓库自带的示例项目测试过插件参考 project.godot该示例项目已预启用插件可以跳过本步直接从第 2 步开始。第 2 步复制 addons 目录到你的 Godot 项目这是最关键的一步。把 Godot-MCP 仓库中的godot_mcp文件夹整体复制到你自己的 Godot 项目的addons目录下若项目没有addons目录则新建一个你的Godot项目/ ├── addons/ │ └── godot_mcp/ ← 把整个文件夹拷进来 │ ├── plugin.cfg │ ├── mcp_server.gd │ └── ... ├── project.godot └── ...⚠️注意复制的是godot_mcp文件夹本身不要复制成addons/godot_mcp/godot_mcp这样的嵌套结构。第 3 步在 Godot 中启用插件用 Godot4.x 版本打开你的项目进入菜单栏Project → Project Settings → Plugins在列表中找到Godot MCP勾选启用它 ✅启用后mcp_server.gd会在_enter_tree()时自动启动 WebSocket 服务器并监听 9080 端口同时编辑器右侧停靠栏会出现 MCP 控制面板。第 4 步验证安装成功打开右侧停靠面板Dock确认能看到MCP 面板对应 addons/godot_mcp/ui/mcp_panel.tscn 场景打开 Godot 的输出控制台Output应看到 MCP SERVER STARTING 与Listening on port 9080的日志面板状态指示变绿说明服务器已就绪AI 可以随时连进来干活 四、常见问题排查Troubleshooting问题解决办法Plugins 列表里找不到 Godot MCP检查文件夹是否放在addons/godot_mcp/plugin.cfg路径多一层或嵌套都会导致识别失败端口启动失败确认 9080 端口未被其他程序占用查看 Output 中的Failed to listen on port错误macOS 无法联网在系统设置中给 Godot 编辑器授予本地网络权限修改配置后不生效重启 Godot 编辑器让插件重新加载五、下一步连接 AI 助手插件启用后还需要配置 MCP 服务端并把它接入 Claude Desktop。完整流程可参考项目自带文档安装全流程docs/installation-guide.md上手示例让 AI 帮你搭场景、写移动脚本docs/getting-started.md完整命令清单docs/command-reference.md架构设计原理docs/architecture.md配置完成后你就可以用自然语言指挥 AI创建一个主菜单包含开始、选项和退出按钮——剩下的节点搭建和脚本编写交给 Godot-MCP 插件自动完成吧✨【免费下载链接】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），仅供参考