hi-godot/godot-ai

解决的问题

Godot AI 允许 AI 助手（如 Claude Code、Claude Desktop 和 Cursor）直接与实时运行的 Godot 游戏引擎编辑器交互。这消除了用户手动复制粘贴代码或手动设置场景的需求，使 AI 能够实时构建场景、编辑节点和配置游戏环境。

工作原理

该项目实现了模型上下文协议（MCP），充当 AI 客户端与 Godot 编辑器之间的桥梁。通信流程如下：

1. MCP 客户端：AI 助手（例如 Claude）发送请求。
2. 桥梁：Python 服务器（godot-ai attach）通过 stdio 处理请求。
3. Godot 编辑器：Godot 编辑器中的插件接收经过身份验证的 WebSocket 连接并执行操作。

它提供了 46 个工具和超过 120 个操作来操作编辑器，包括脚本编辑、信号连接和 UI 配置。

适用人群

使用 Godot 引擎（4.7+）的游戏开发者，希望利用 LLM 自动化基于编辑器的游戏开发中的重复性任务，例如构建场景、配置材质和设置玩家控制器。

亮点

• 深度编辑器集成：可以构建场景、编辑节点、连接信号，并配置 UI、材质、动画和粒子。
• 广泛的客户端支持：兼容 Claude Code、Claude Desktop、Codex、Cursor、VS Code 等。
• 广泛的脚本支持：完全支持 GDScript，具有解析验证和热重载功能；对 C# 仅提供文本支持。
• 安全通信：使用独立的轮换能力和经过身份验证的 HTTP/WebSocket 连接，确保本地回环安全。