Godot AI 教程:46 个 MCP 工具,让 Claude Code 直接操作 Godot 编辑器

📌 项目地址: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编辑器桥接教程。

✨ 能力清单(46 工具 / 120+ 操作)

领域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 项目 → 启用插件 → 客户端里开聊

💡 使用建议

📚 常见问题

Godot AI 是什么?

一个把 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# 支持有何差别?

GDScript 完整支持:通过工具写入的脚本会被解析验证、热重载、挂载并生成大纲。C# 仅文本级:script_create/script_patch 能写 .cs 文件、find_symbols 能生成大纲,但 Godot AI 不构建 .NET、也不报 C# 编译器错误——需要在编辑器里构建看 Build 面板,或跑 dotnet build 看终端输出;挂载 .cs 还需要启用 .NET 的编辑器构建。