📌 项目地址:github.com/hi-godot/godot-ai | 星数:2692+ | 要求:Godot 4.7+(4.x 线)、uv、MCP 客户端
AI 写游戏代码容易,但「建场景、摆节点、连信号」这些编辑器操作 AI 一直插不上手。Godot AI 用 MCP 协议把 Claude Code / Claude Desktop / Codex / Hermes Agent 直接连到正在运行的 Godot 编辑器:46 个工具、120+ 操作,从建场景到配材质动画粒子相机全部交给 AI。官方 demo(赛博朋克 HUD,源码公开)约 2 小时全程 AI 搭建、无手写代码。Unity 阵营的同类方案见 Unity MCP编辑器桥接教程。
| 领域 | AI 可执行的操作 |
|---|---|
| 场景 | 创建场景、添加/编辑节点、层级管理 |
| 脚本 | GDScript 写入即解析验证 + 热重载 + 挂载 + 大纲;C# 文本级写入 |
| 信号 | 节点信号接线 |
| 表现层 | UI、材质、动画、粒子、相机、环境配置 |
# 前置:Godot 4.7+(4.x)· uv(提供 uvx)· 任一 MCP 客户端
# 1. Godot 侧(编辑器插件)
# 从 GitHub Releases 选发布版本
# 解压到 your-project/addons/godot_ai/
# (plugin.cfg 需在该目录内;用 release 包,
# 不要拿源码快照覆盖旧安装)
# 2. MCP 侧
# 在 Claude Code / Claude Desktop / Codex 等
# 客户端配置中注册 Godot AI 服务器
# (uvx 启动 Python 服务)
# 3. 打开 Godot 项目 → 启用插件 → 客户端里开聊
一个把 Claude Code、Claude Desktop、Codex、Hermes Agent 等 MCP 客户端连到活的 Godot 编辑器的开源项目(hi-godot/godot-ai,2692 星):46 个工具、120+ 操作,让 AI 助手直接建场景、编辑节点与脚本、连信号,配置 UI、材质、动画、粒子、相机和环境。官方 demo(赛博朋克 HUD)约 2 小时全程 AI 搭建、无手写代码。
需要 Godot 4.7+(4.x 线)、uv(提供 uvx 运行 Python 服务器)和一个 MCP 客户端。安装分两半:Godot 侧从 GitHub Releases 选发布版装到 your-project/addons/godot_ai/(含 plugin.cfg,用 release 包而非源码快照);MCP 侧在客户端配置里注册该服务器。详见仓库文档。
GDScript 完整支持:通过工具写入的脚本会被解析验证、热重载、挂载并生成大纲。C# 仅文本级:script_create/script_patch 能写 .cs 文件、find_symbols 能生成大纲,但 Godot AI 不构建 .NET、也不报 C# 编译器错误——需要在编辑器里构建看 Build 面板,或跑 dotnet build 看终端输出;挂载 .cs 还需要启用 .NET 的编辑器构建。