hi-godot/godot-ai

解决的问题

Godot AI 允许 AI 助手（如 Claude Code 或 Codex）直接与实时的 Godot 游戏引擎编辑器交互。它消除了用户在 AI 聊天和引擎之间手动复制粘贴代码或场景配置的需要，使 AI 能够实时地程序化构建场景、编辑节点并配置游戏环境。

工作原理

该项目使用 Model Context Protocol (MCP) 来连接 AI 客户端与 Godot 编辑器。一个 Python 服务器（使用 FastMCP）充当中介，通过 WebSockets 与 Godot 编辑器插件连接。AI 客户端通过 HTTP 或 stdio 桥接与该服务器通信，从而触发 43 个工具中的 120 多个操作，例如创建节点、连接信号和编辑脚本。

适用人群

使用 Godot Engine（版本 4.5+）并希望利用 AI 代理自动化游戏开发中繁琐部分（如 UI 布局、场景组装和基础脚本编写）的游戏开发者。

主要亮点

• 深度编辑器集成：可程序化构建完整场景，配置材质、动画、粒子和摄像机。
• 广泛的客户端支持：兼容多种 MCP 客户端，包括 Claude Code、Claude Desktop、Cursor 和 Zed。
• 完全从代码构建的 UI：无需外部图像生成，即可程序化绘制复杂 UI。
• 集成测试功能：内置编辑器内 GDScript 测试框架，AI 客户端可用来编写和运行游戏测试套件。