godot-ai

Godot AI Godot AI 将 Claude Code、Claude Desktop、Codex 和 Hermes Agent 等 MCP 客户端连接到正在运行的 Godot 编辑器。它提供 46 个工具和 120 多种操作，让 AI 助手能够构建场景、编辑节点与脚本、连接信号，以及配置 UI、材质、动画、粒子、摄像机和环境。 快速开始 要求 - Godot AI v4 需要 Godot 4.7+（4.x 系列内） - uv（为 Python 服务器提供 uvx） - 一个 MCP 客户端 安装 1. 新项目：从 GitHub Releases 下载已发布版本，并将附加组件安装到 your-project/addons/godot_ai/，plugin.cfg 需位于该目录中。 2. 现有安装：使用 Godot AI 停靠面板中的 Update 按钮。最终签名版 v3 支持一键迁移到 v4。 启用插件 在 Godot 中：项目 → 项目设置 → 插件 → Godot AI。 插件会启动 MCP 服务器，并在 Godot AI 停靠面板中显示连接状态。 连接 MCP 客户端 在停靠面板中，按客户端旁边的 Configure，或按 Configure all 配置所有检测到的客户端。支持的客户端包括 Claude Code、Claude Desktop、Codex、Antigravity、Hermes Agent、DeepSeek Harness、Cursor 和 VS Code。 试用 示例提示词： - “显示当前场景层级。” - “在 /Main 下创建一个名为 MainCamera 的 Camera3D。” - “在 ui/ 中搜索项目里的 PackedScene 文件。” - “运行场景测试套件。” - “构建一个体素方块世界游戏，包含玩家、可放置和破坏的方块，以及存档槽。” 工作原理 MCP 客户端 → godot-ai attach（stdio）→ Python 服务器（已认证 HTTP，端口 8000）→ Godot 编辑器插件（已认证 WebSocket，端口 9500） 两个本地跳转都使用独立轮换的访问能力，且都不会回退到未认证访问。编辑器 WebSocket 仅保持环回连接。对于容器中或其他机器上的代理，请通过 SSH 在编辑器机器上运行网桥。 遥测与隐私 使用遥测会记录安装 UUID、事件、结果、持续时间、平台和版本，但不记录代码、场景内容或项目/文件名。项目目录 slug 会在传输前进行哈希处理。 可通过 GODOT_AI_DISABLE_TELEMETRY=true 或 DISABLE_TELEMETRY=true 退出遥测。 文档与帮助 Bazzite / Fedora Atomic Desktop 问题 在 Bazzite 和其他 Fedora Atomic 桌面上，/home 通常是指向 /var/home 的符号链接。Godot AI 4.0.2 及更早版本会拒绝所有经过链接的能力目录路径。下一版本会在链接为 root 所有，并且位于其他账户无法写入的 root 所有目录中时跟随该链接。 对于 4.0.2 或更早版本，请将 GODOT_AI_CAPABILITY_DIR 设置为规范路径，并从该终端启动 Godot 和 MCP 客户端。 参考与支持 - 工具、操作和资源 - 为游戏编写并运行测试 - 客户端配置详情 - 从 v3 升级以及恢复中断的迁移 - 变更日志 - 贡献与开发环境设置 - Discord 用于提问和作品展示；GitHub Issues 用于错误报告 许可证：MIT