用途:面向 Godot Engine 4.x 的 MCP 服务器插件,让 AI 助手通过自然语言控制 Godot 项目,可创建节点、编辑脚本、管理场景并调试游戏。工具以 GDScript 原生实现,无外部依赖。
主要能力:共 154 个工具。节点操作(获取场景树、创建/删除/复制/移动/重命名节点、批量更新属性);脚本操作(列出、读取、创建、修改、附加、执行、分析、校验脚本);场景操作(创建、保存、打开、获取当前场景、列出项目场景、场景继承与实例化审计);编辑器操作(编辑器状态、运行/停止项目、截图、选择节点、检查器属性);高级节点工具(锚点预设、连接信号、批量更新);调试与运行时(编辑器日志、调试打印、性能指标、安装运行时探针、运行时场景树、检查与修改运行时节点、求值运行时表达式、调试器会话、断点、调用栈与变量、单步与继续);导出相关校验(列出导出预设、校验导出预设、检查导出模板)。
使用方式:可通过 AssetLib 搜索安装,或手动克隆到项目 addons 目录(git clone https://github.com/yurineko73/Godot-MCP-Native.git godot_mcp),再在 项目 > 项目设置 > 插件 中启用。插件默认在 9080 端口运行 HTTP MCP 服务器,可在 项目 > 项目设置 > Godot MCP 中配置 transport_mode、http_port、auth_enabled、auth_token。可连接 Claude Desktop(借助 mcp-remote,npm install mcp-remote)、Cursor/Trae(.cursor/mcp.json 或 .trae/mcp.json)、Cline、OpenCode、Codex,地址为 http://localhost:9080/mcp;启用认证时需加 Authorization: Bearer 头。
适用场景:用 AI 辅助搭建 3D 角色、UI 菜单、批量场景编辑,或通过运行时探针调试游戏状态。
限制:需 Godot Engine 4.x 且项目处于打开且插件已启用状态;若端口或防火墙不通、节点路径写法不符、属性名大小写或类型不匹配、脚本路径未以 res:// 开头、运行时探针未在运行项目前安装等,均可能导致调用失败。其余未在资料中说明的功能、收费、价格与平台信息暂未提供。