企业官网建设流程全解析

Godot AI 是什么？让AI直接在编辑器里造游戏的MCP服务器完整指南

【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-ai

Godot AI是一个面向 Godot 引擎的生产级 MCP 服务器：它把 Claude Code、Codex、Cursor 等 AI 助手直连到你正在打开的 Godot 编辑器，内置46 个工具、120+ 项操作，让 AI 用自然语言直接搭建场景、编写脚本、连接信号、配置 UI 和动画——整个过程就发生在编辑器里，无需手写代码。

用几条提示词搭出的 3D 方块世界：玩家移动、碰撞、存档系统一应俱全

为什么要把 AI 接进 Godot 编辑器

传统的「AI 写代码」方式有个天然断层：AI 只能输出文本，它看不到你的场景树，改错了也没法即时验证，调试全靠人肉来回粘贴。

Godot AI 解决的正是这个问题：

• 🎯直接操作编辑器：AI 创建节点、改属性、连信号，结果实时呈现在场景树中，所有场景修改支持Ctrl+Z 撤销
• ⚡写码即验证：AI 写的 GDScript 会经过解析校验并热重载，出错时 AI 能直接读到编辑器报错日志，自己继续修
• 🕹️能玩你正在运行的游戏：AI 可以注入按键/鼠标输入、读取游戏节点状态、截取游戏画面，甚至逐帧编排输入序列来复现 bug

一个赛博朋克 HUD 界面，在 Godot AI 辅助下约 2 小时完成，全程未手写一行代码

3 分钟上手：Godot AI 安装与配置步骤

第一步：确认前置要求

• Godot4.7+（4.x 系列；Godot AI v4 明确支持 4.7 及以上）
• uv（为 Python 服务端提供uvx）
• 一个 MCP 客户端（Claude Code、Codex、Cursor、VS Code 等，下文详述）

第二步：启用插件

从 Releases 获取已发布的签名版本，将插件放入项目的addons/godot_ai/目录（plugin.cfg应位于该目录内），然后在 Godot 中依次点击：

项目 → 项目设置 → 插件 → 启用 Godot AI

插件会自动启动 MCP 服务器，并在编辑器右侧Godot AIdock 面板中显示连接状态。

第三步：一键连接你的 AI 客户端

在 dock 面板中，点击你使用的客户端旁的Configure按钮（或Configure all一键配置全部已检测到的客户端）。若客户端没有感知到配置变更，重启它即可。

第一次让 AI 造游戏

连接成功后，试试这些提示词：

• “给我看当前场景的层级结构”
• “在 /Main 下创建一个名为 MainCamera 的 Camera3D”
• “搜索项目里 ui/ 目录下的 PackedScene 文件”
• “做一个体素方块世界游戏，包含玩家、可放置/破坏的方块和存档槽位”

由提示词生成的方块世界游戏，含四档存档槽、载入/删除与生涯统计

Godot AI 能做什么？46 个工具的功能全景

Godot AI 将能力划分为28 个功能域，每个域提供一个<domain>_manage聚合工具（通过op参数分派具体操作），高频操作则直接暴露为独立工具。核心域一览：

完整工具与操作清单见 docs/TOOLS.md。

Godot AI 工作原理：从提示词到游戏画面的三层架构

Godot AI 的链路简洁透明，每一层各司其职：

MCP 客户端（你的 AI 助手） → godot-ai attach（stdio 桥接） → Python 服务器（本地认证 HTTP，端口 8000） → Godot 编辑器插件（本地 WebSocket，端口 9500）

• AI 客户端通过MCP 协议调用工具；
• Python 服务端（源码位于 src/godot_ai/handlers/）负责路由命令与参数校验；
• GDScript 编辑器插件（位于 plugin/addons/godot_ai/）调用 Godot 编辑器 API 真正执行操作，结果原路返回。

两条本地链路都只绑定回环地址（loopback），并使用独立轮换的能力令牌做认证——不存在未认证的回退通道。完整架构与安全模型见 docs/plugin-architecture.md。

支持哪些 AI 客户端？

Godot AI 的客户端注册表覆盖主流 AI 编程工具，dock 面板会列出所有受支持的客户端并提供Run this manually手动兜底：

• Claude Code / Claude Desktop、Codex
• Cursor、VS Code（含 Insiders）、Windsurf
• Antigravity、Hermes Agent、DeepSeek Harness、Kimi Code、Qwen Code、Cline等 20+ 客户端

每个客户端的配置文件写法（JSON / TOML / YAML / CLI 命令等）都由 plugin/addons/godot_ai/clients/ 中的描述符自动处理，你只需要点Configure。配置细节见 docs/client-configuration.md。

安全与隐私：AI 能碰到你的项目吗

• 🛡️纯本地通信：WebSocket 仅监听本地回环，HTTP 优先本机，且每一跳都需认证令牌
• 📡遥测最小化：默认遥测只记录安装 UUID、事件、结果、耗时、平台与版本——不记录代码、场景内容、项目或文件名（项目目录名在传输前哈希）。可用GODOT_AI_DISABLE_TELEMETRY=true完全关闭，详见 docs/TELEMETRY.md
• 🔄一切可撤销：场景修改统一走 Godot 的EditorUndoRedoManager；确实无法撤销的文件写入会在响应中明确标注"undoable": false

进阶：扩展工具、写测试与多编辑器协作

• 🧩社区插件：第三方 add-on 可注册自定义工具，通过custom_manage发现与调用；例如社区 Terrain Tools 为 AI 增加了高度图地形雕刻能力，目录见 docs/community-addons.md
• 🧪让 AI 帮你写测试：把test_*.gd文件放进res://tests/即被自动发现，用test_run一键在编辑器内执行，作者指南见 docs/testing.md
• 👥多编辑器 / 多客户端：多个 Godot 编辑器可同时接入一个服务器，任意工具调用都支持传session_id指定目标编辑器；完整能力边界见 docs/TOOLS.md

由 Godot AI 辅助构建的 HUD 界面局部：生命体征、小地图、信用额度与系统日志

常见问题 FAQ

Q1：Godot 版本有什么要求？Godot AI v4 要求 Godot4.7+（4.x 系列）。插件会在启动时检查引擎版本，4.5 / 4.6 会给出明确的拒绝提示并保持静默。

Q2：AI 改坏了我的场景怎么办？所有场景层操作（建节点、改属性、复制、重排）都走编辑器的撤销栈，Ctrl+Z 即可回滚；文件写入类操作不可撤销，但响应中会明确告知原因。

Q3：必须用 Claude 吗？不是。Godot AI 只认 MCP 协议，上文的 20+ 客户端均可连接；dock 面板提供一键配置与手动兜底命令。

Q4：游戏运行时 AI 能参与调试吗？可以。AI 能注入按键 / 鼠标 / 手柄输入（支持帧级精确序列）、读取运行中游戏节点、截取游戏画面、读取游戏日志——见 docs/TOOLS.md 中的game_manage域。

Q5：如何跟进项目更新？查看 CHANGELOG.md，并在 dock 面板中出现更新时点击Update（v3 用户可一键迁移到 v4，详见 docs/v4-migration.md）。

继续深入：文档与源码地图

• 工具与操作总表：docs/TOOLS.md
• 插件架构与安全模型：docs/plugin-architecture.md
• 客户端配置详解：docs/client-configuration.md
• 测试编写指南：docs/testing.md
• 遥测与隐私说明：docs/TELEMETRY.md
• Python 服务端源码：src/godot_ai/
• Godot 插件源码：plugin/addons/godot_ai/

Godot AI把「AI 造游戏」从聊天框搬进了编辑器：46 个工具、可撤销、纯本地、免费开源（MIT 协议）。装好插件、点一下 Configure，你的 AI 助手就能开始在你的 Godot 项目里动手了 🎮

【免费下载链接】godot-aiProduction-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.项目地址: https://gitcode.com/gh_mirrors/go/godot-ai