Godot-MCP 指南：用自然语言创建和编辑 Godot 场景的 3 步接入教程

Godot-MCP 指南用自然语言创建和编辑 Godot 场景的 3 步接入教程【免费下载链接】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 引擎连接起来的 MCPModel Context Protocol集成工具。安装一个 Godot 插件加一个本地 MCP 服务器后你可以用自然语言在编辑器里创建节点、修改 GDScript、管理场景与项目资源无需手写编辑器操作。它适合两类人想降低 Godot 入门门槛的新手以及希望快速搭建原型的开发者。它解决什么问题在 Godot 里改一个节点属性、建一层 UI通常要手点菜单、查文档、写胶水脚本。Godot-MCP 把这些操作变成对话AI 通过插件直接读写编辑器你只负责描述目标结果立刻反映在场景树里。安装配置步骤跑通第一次对话前置条件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配置 Claude Desktop。编辑其配置文件macOS 位于~/Library/Application Support/Claude/claude_desktop_config.json可参照仓库内的 claude_desktop_config.json加入{ mcpServers: { godot-mcp: { command: node, args: [/你的绝对路径/Godot-MCP/server/dist/index.js], env: { MCP_TRANSPORT: stdio } } } }把路径替换为仓库在你机器上的实际位置保存后重启 Claude Desktop。在你的 Godot 项目中启用插件把addons/godot_mcp拷入项目 addons 目录在「Project Project Settings Plugins」中启用Godot MCP右侧停靠区会出现 Godot MCP Server 面板。在面板中确认端口默认 9080点击 Start Server仓库自带的示例项目已启用插件可直接打开 project.godot 验证。场景演示对 AI 说什么得到什么演示 1看清当前项目。在 Claude 里发mcp godot-mcp run get-scene-treeAI 返回完整场景树结构你可以接着问「这个场景里有哪些节点可以复用」。它也能读取资源端点如godot://script/current当前脚本、godot://scene/current当前场景、godot://project/info项目信息。演示 2搭一个主菜单。直接说Create a main menu with play, options, and quit buttonsAI 会调用节点类工具创建 CanvasLayer 与 Button 节点并生成按钮点击处理脚本你在场景树里能看到新增的 UI 层级。演示 3审查并修复脚本。mcp godot-mcp read godot://script/current 帮我看下这个移动逻辑有没有问题并给出修复方案对应底层是 read-script / analyze-script 这类工具若它给出改法你可以再追加一句让它写入modify-script改完按 F5 在编辑器里运行验证。让 AI 更好用的 5 个做法具体描述写明节点类型、属性值、路径而不是「弄个差不多的」从简单任务开始先创建单个节点、单个脚本再扩展到多步功能小步迭代每改一小步就运行验证避免一次性大改难以定位问题提供项目上下文主动说明当前场景结构和已有节点命名可采纳也可改AI 的建议不满意就让它换一种实现不必手动回退排错排查清单常见现象与检查项现象检查项Claude 连不上 Godot插件是否启用面板中 WebSocket 服务器是否已启动两端端口是否一致默认 9080防火墙是否拦截 localhost命令执行报错看 Godot 控制台和 MCP 面板日志确认项目有已打开的活动场景路径是否以res://开头节点类型与属性名是否拼写正确修改没出现在编辑器变更后再保存场景重载 Godot 项目核对 Claude 配置里的服务器路径是否为绝对路径且存在深入源码与文档插件端addons/godot_mcp/其中 commands/ 下按节点、脚本、场景、项目、编辑器分了五类命令处理器服务器端server/src/tools/ 定义暴露给 Claude 的工具server/src/utils/godot_connection.ts 维护与 Godot 的 WebSocket 连接文档docs/getting-started.md上手流程、docs/command-reference.md完整命令参数表、docs/installation-guide.md安装细节、docs/architecture.md通信协议与架构下一步按上面的 4 步把环境跑通在 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），仅供参考