godot-ai
活跃·★ 3.1k·MIT·更新于 2026-10-22
★ 必备神器★ 时下流行
Godot AI 把 Claude Code、Codex、Antigravity 等 MCP 客户端直接连到运行中的 Godot 编辑器。README 说约 39 个 MCP 工具共提供 120 多种操作,让助手可以搭建场景、编辑节点、搜索项目并运行场景测试,完整清单在 docs/TOOLS.md。示例提示词包括查看场景层级、在某节点下创建 Camera3D、构建体素方块世界游戏,README 还展示了一个约两小时、无需手写代码做出的界面演示。
它分三层:使用 Godot 的 EditorInterface 和 SceneTree API 的编辑器插件、监听 8000 端口的 Python FastMCP 服务,以及 9500 端口的 WebSocket 连接。要求是 Godot 4.3 或更高版本(推荐 4.4+)、用于 Python 服务的 uv,以及一个 MCP 客户端。安装方式是把 `addons/godot_ai` 复制进项目,或从 Godot Asset Library 安装(版本可能落后于 GitHub),启用插件后在编辑器面板里自动配置客户端;支持的客户端很多,其余的有手动配置片段。服务地址是 `http://127.0.0.1:8000/mcp`。许可证为 MIT。
#Godot引擎#AI集成#模型上下文协议 (MCP)#游戏开发#编辑器自动化#Python后端#AI助手#场景操作
01
功能特性
01通过模型上下文协议(MCP)与Godot引擎4.3+直接集成。
02为AI助手提供跨39种MCP工具的120多种编辑器操作。
03允许AI构建场景、编辑节点、脚本,并配置各种游戏资产(UI、材质、动画)。
04支持Claude Code、Codex和Antigravity等主流MCP客户端。
05插件自动启动使用`uv`的Python后端服务器进行MCP通信。
02
为什么选择它
+直接作用于运行中的编辑器,助手编辑的就是你打开的那个场景
+工具很多:120 多种操作,包括搭场景、编辑节点、搜索项目和运行测试
+既能从源码安装,也上架了 Godot Asset Library,并能为许多 MCP 客户端自动配置
+服务只监听本机 127.0.0.1
03
权衡点
!需要 Godot 4.3+、uv,以及一个与编辑器同时运行的 Python 服务
!按 README 所述,Asset Library 的版本可能落后于 GitHub
!助手会直接修改你打开的项目,让它编辑场景前请先用好版本控制
!展示的演示出自作者本人,在你自己项目上的效果取决于模型和提示词
04
维护状况检查
活跃检查日期: 2026-10-22
- 最近提交
- 2026-10-03
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 25
- 最新发布
- v4.3.0 (2026-10-03)
- 未关闭 issue
- 42
- 近期 issue 至少有一条评论的比例
- 3/23
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #1147 filesystem_manage(op:"reimport") reports files as reimported when no import ran7 条评论 · 2026-10-04
- #823 Attach bridge: support response-stream resumption across same-instance disconnects4 条评论 · 2026-07-23
- #1120 filesystem_manage remove/move/rename refused ~60% of the time; discovery-limit refusals and 25 s deadline expiries reported as INVALID_PARAM3 条评论 · 2026-09-28
- #1105 Windows self-update intermittently blocks on process identity capture after activation3 条评论 · 2026-09-22
- #1113 Steam nested namespaces can expose credential-path ancestors as unmapped UID 655342 条评论 · 2026-09-24
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
05
兼容性
Godot Engine
编辑器
已通过文档验证
Python
后端
已通过文档验证
Model Context Protocol (MCP)
客户端协议
已通过文档验证
macOS
操作系统
已通过文档验证
Linux
操作系统
已通过文档验证
Windows
操作系统
已通过文档验证
06
快速开始
1
$ git clone https://github.com/hi-godot/godot-ai.git
2
$ cp -r godot-ai/plugin/addons/godot_ai your-project/addons/
07
使用场景
↳使用AI快速原型设计和程序化生成游戏场景和环境。
↳通过自然语言自动化复杂的Godot编辑器任务,例如连接信号或设置UI布局。
↳使AI助手能够理解、分析和修改现有的Godot项目。
↳从高级提示构建完整的迷你游戏,展示先进的AI驱动开发。
08
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧