什么是 Godot MCP?
Godot MCP 是一个 Godot 引擎的插件，它作为你的 Godot 项目与 AI 助手之间的桥梁，使用标准化的模型上下文协议。它允许 AI 工具直接访问、分析和修改脚本、场景、节点和项目设置，从而为开发、调试和创作协作启用全新的 AI 驱动工作流程。
如何配置 Godot MCP
- 克隆
godot-mcp仓库并导航到其目录。 - 在
/server目录中运行npm install和npm run build来构建和设置 MCP 服务器。 - 编辑你的 Claude Desktop 配置文件（如
claude_desktop_config.json），添加指向你构建的服务器入口文件的 MCP 服务器条目。 - 确保将
PATH_TO_YOUR_PROJECT替换为你克隆的仓库的绝对路径。 - 重启 Claude Desktop 以应用更改。
- 在 Godot 中，打开提供的示例项目或将
addons/godot_mcp文件夹添加到你自己项目的 addons 目录。 - 在 Godot 编辑器中，从项目 > 项目设置 > 插件中启用该插件。
如何使用 Godot MCP
在 MCP 服务器运行且插件已启用的情况下，使用结构化或自然语言提示从 AI 助手界面（如 Claude Desktop）与 Godot 项目进行交互。在命令前加上 @mcp godot-mcp 来通过 MCP 服务器发送请求。你可以请求代码建议、场景更改、AI 生成的内容，并直接运行项目或资源命令。
示例提示
@mcp godot-mcp read godot://script/current
"我需要帮助优化我的玩家移动代码。你能建议改进吗？"@mcp godot-mcp run get-scene-tree
"在场景中间添加一个立方体，然后做一个观察这个立方体的相机。"@mcp godot-mcp read godot://scene/current
"创建一个在路标之间巡逻，并在玩家靠近时攻击的敌人 AI。"
主要特性
- Godot 与 AI 助手之间的无缝双向通信
- 程序性访问和修改项目资源、脚本、场景和节点
- 丰富的命令集用于节点管理、脚本编辑、场景和项目控制
- 可以轻松扩展，增加额外的 MCP 工具端点
- 安全的本地或远程设置，支持通过 Claude Desktop 集成
- 通过自然语言提供 AI 驱动的编程、调试和场景创建协助
使用案例
- 针对 GDScript 文件的 AI 驱动代码评审、生成和重构
- 自动场景创建、节点管理和程序化环境生成
- 进行项目范围的分析以优化性能或检测错误
- 通过 AI 提示实现游戏逻辑、AI 行为和 UI 元素
- 通过 AI 指导批量编辑或创建资源和设置
- 加速 Godot 项目的原型制作、学习或协作开发
常见问题
问：插件无法工作或在 Godot 中没有出现。我该怎么办？
答：确保在项目 > 项目设置 > 插件中启用了 "Godot MCP" 插件。如果你最近复制了插件或进行了配置更改，尝试重新加载项目，并检查 Godot 控制台中的错误信息。
问：Claude Desktop 无法连接到 MCP 服务器。怎么回事？
答：确认服务器成功运行（启动时没有错误），并确保你的 Claude Desktop 配置具有正确的绝对路径。确保 MCP_TRANSPORT 设置为 stdio。更新配置后重启 Claude Desktop。
问：我可以在现有项目中使用 Godot MCP，还是只能在包含的示例中使用？
答：是的，你可以在任何 Godot 项目中使用它。只需将 addons/godot_mcp 文件夹复制到你的项目的 addons 目录中，并从设置中启用插件。
问：如果我想扩展 Godot MCP 或添加自定义命令怎么办？
答：该插件和服务器是开源的，旨在便于扩展。你可以在 MCP 服务器中实现新的端点，或扩展 Godot 插件以公开其他功能。
问：使用 Godot MCP 时，我项目的数据安全吗？
答：是的，默认情况下，MCP 服务器在你的本地机器上运行，仅访问你允许的文件和数据。查看服务器配置，并始终记住数据安全的最佳实践。