自定义工具与社区插件扩展Godot AI能力边界的实用指南附遥测隐私与关闭方法【免费下载链接】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-aiGodot AI是一款为 Godot 引擎打造的免费、开源 MCP模型上下文协议服务器与 AI 工具集它把 Claude Code、Codex、Cursor 等 AI 客户端直接接入正在运行的 Godot 编辑器提供 46 个工具和 120 操作让 AI 助手能创建场景、编辑节点与脚本、连接信号、配置 UI、材质和动画。当内置工具还不够用时你可以用自定义工具和社区插件进一步扩展它的能力边界同时本文也会讲清 Godot AI 遥测采集了什么、如何一键关闭。一、内置工具能力基线Godot AI 的工具分为 19 个命名工具和 27 个按领域归组的domain_manage工具如scene_manage、material_manage覆盖场景、节点、脚本、动画、相机、粒子、音频、主题等领域文档见 docs/TOOLS.md。这个 HUD 演示是在约 2 小时内、几乎不手写代码的情况下用 Godot AI 构建的。对于更复杂的玩法比如带存档系统的方块世界游戏内置工具通常足够——但如果你做的是地形雕刻、单元测试自动化等垂直场景就该考虑扩展了。二、自定义工具让你的插件长出AI 能力 ️什么是自定义工具任何第三方 Godot 插件addon都可以通过custom_tools/注册表把自己的功能注册为 MCP 工具AI 客户端就能直接调用它们。核心 API 只有两个类McpCustomToolSpec描述一个工具——名称、给 AI 看的说明、参数 JSON Schema、处理函数路径等McpToolRegistry注册入口插件通过register(spec)或原子批量batch_register([...])注册。注册时会自动做预算校验说明不超过 600 字符、Schema 不超过 8 KB、超时 500~120000 毫秒防止某个插件把巨量文本塞进工具目录。两种暴露方式custom_manage默认所有已启用的自定义工具都可以通过custom_manage(oplist)发现、custom_manage(opinvoke)调用提升为一等工具promoted true可选注册为名为custom_name的正式 MCP 工具AI 客户端能原生校验参数。服务端对提升数量设有上限见 MAX_PROMOTED_TOOLS超出的部分仍可通过custom_manage访问。服务端侧的目录同步逻辑在 custom_tool_service.py插件每有变化就推送一次完整快照AI 客户端随即刷新工具列表——所以新增工具后无需重启任何客户端。用户侧的开关Dock 的 Tools 选项卡Dock 的 Tools 选项卡会列出所有已注册的自定义工具及其来源插件每个工具有独立复选框。禁用立即生效被禁用的工具不再向 AI 客户端广播、调用时返回CUSTOM_TOOL_DISABLED错误且该选择按项目持久化保存。这意味着你可以精确控制哪些扩展能力暴露给 AI。三、社区插件开箱即用的扩展生态 不想自己写可以直接安装社区 addon。官方目录见 docs/community-addons.mdAddon提供能力版本要求Godot AI Terrain Tools高度图地形创建、雕刻、侵蚀、道路与绘制等编辑器工具Godot 4.7Godot AI 4.1这些 addon 由各自作者维护与 Godot AI 并列安装即可。官方也提供了发布自己的 addon的路径参考 docs/plugin-architecture.md 中Custom Tools (Third-Party Addons)一节的注册示例约从 第 628 行 开始其中展示了如何构造McpCustomToolSpec、声明requires_writable写操作在编辑器播放/导入期间会被自动拦截和undoable参与可撤销批量执行等执行契约。四、遥测与隐私采集了什么如何完全关闭 采集清单匿名、最小化Godot AI 默认开启匿名遥测用于了解工具使用情况、发现性能回退、优先修复 bug。全部代码开源位于 src/godot_ai/telemetry.py 和 plugin/addons/godot_ai/telemetry.gd。要点匿名仅生成一个随机安装 UUID无账号、无邮箱、无机器指纹会话 ID 加盐哈希项目目录名在发送前做 SHA-256 加盐哈希跨用户不可关联、不可逆推绝不采集源代码、场景内容、文件路径、项目名发送前已哈希、编辑器日志、任何可识别用户的信息。每次工具调用只记录一条记录工具名、子操作、成功与否、耗时、失败时的错误类别错误消息文本永不离开进程因为它可能包含路径。完整说明见 docs/TELEMETRY.md。方法一编辑器 UI 一键关闭打开 Godot AI Dock点Clients Tools弹窗切到Settings选项卡取消勾选Telemetry复选框实现位于 mcp_dock.gd点击Apply Restart Server。偏好会写入 Godot 编辑器设置并跨重启持久化。对插件启动的服务关闭会以环境变量GODOT_AI_DISABLE_TELEMETRY注入对插件接管的已运行服务则通过已认证的 WebSocket 发送telemetry_opt_out指令服务端立即停止发送——且该指令只能关闭、不能远程开启多编辑器共享时最严格偏好获胜。方法二环境变量关闭在启动 Godot 和 AI 客户端前设置任一变量export GODOT_AI_DISABLE_TELEMETRYtrue # 或 DISABLE_TELEMETRYtrue一旦关闭不生成 UUID、不启动工作线程、不创建本地文件下次以遥测关闭状态启动时本地遗留的遥测文件customer_uuid.txt、milestones.json会被删除。自托管提示遥测端点可用GODOT_AI_TELEMETRY_ENDPOINT环境变量改为你自己的收集器配置无效时会直接停发并告警而不会静默回退到默认端点——误配置绝不会把数据发给维护者。五、小结扩展路径速查 ✅目标做法关键文件查看有哪些工具/操作内置 46 工具 27 领域归组docs/TOOLS.md安装社区扩展与 Godot AI 并列安装 addondocs/community-addons.md编写自定义工具McpCustomToolSpecMcpToolRegistry.registerplugin-architecture.md控制工具暴露Dock → Tools 选项卡逐工具勾选mcp_dock.gd关闭遥测设置选项卡取消勾选或环境变量docs/TELEMETRY.mdGodot AI 的扩展哲学很清晰信任决策留在编辑器进程内暴露决策交给用户。你既可以用几行 GDScript 给 AI 装上专属工具也可以用 Dock 上的复选框随时收回它的能力——能力边界始终在你手中。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考