安装
"command": "npx",
"args": ["-y", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]适合谁
在 Windows(UE 5.4-5.8)或 Linux/macOS(UE 5.6+)上开发 Unreal Engine 项目、希望在 MCP 客户端里用自然语言操作编辑器的开发者与技术美术。官方声称它提供 29 个工具类别、2040+ 个动作,覆盖蓝图、材质、关卡、Actor、动画、VFX、地形、PCG、植被、音频、UI、物理、导航、AI、网络、Sequencer、构建管线等领域,另有一个面向多步工作流的 YAML 流程引擎。如果你常在编辑器里做重复性的场景搭建与资产调整,或想让 AI 接手一部分编辑器操作,它最对口;不打开编辑器的离线流水线则用不上它。判断方法很简单:你的日常作业是否大部分在编辑器里完成、是否愿意让模型直接改动工程资产,两个都答是再往下走。
使用前提是本机工具链齐备:Node.js 18 或更新版本;引擎自带的 PythonScriptPlugin(随引擎附带,init 会替你启用其余所需插件);以及必需的 C++ 工具链——Windows 需要带 C++ 工作负载的 Visual Studio,macOS 需要 Xcode 命令行工具,因为桥接插件会在编辑器首次启动时编译。缺少 C++ 工具链、或不愿在工程里部署 C++ 插件的机器不适合;需要 epic 类别的功能必须用 UE 5.8+。另要注意插件部署是按工程发生的:换工程时需要为新工程重新执行交互式 init 部署桥接插件,并等待它在该工程编辑器首次启动时编译;换工程的完整步骤证据未说明,未确认。许可证、费用与对工程规模的额外要求证据也未提及,需要自行确认。
3 分钟完成第一次尝试
推荐主路径:在 MCP 客户端配置中用 npx 启动服务器并指向你的 .uproject。前提:已装好上文列出的 UE、Node.js 18+ 与 C++ 工具链。
在客户端的配置里加入官方片段:
"command": "npx",
"args": ["-y", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]
把 C:/path/to/MyGame.uproject 换成你的工程文件路径。首次运行会进入交互式设置:自动检测当前目录的 .uproject,让你选择启用哪些工具类别,把 C++ 桥接插件部署进工程,启用所需的 UE 插件(Niagara、PCG、GAS 等),再检测并配置你的 MCP 客户端。
成功信号:编辑器首次启动完成插件编译后,客户端里能看到该服务器的工具类别;对打开的编辑器用自然语言下达一条指令,能观察到编辑器内的实际响应。若类别迟迟不出现,先核对配置里的工程路径是否写对,再等首次编译结束。
注意:官方把它定位为给 AI 助手对编辑器的深度读写访问,写操作会直接改动工程内容;证据未列出单个工具名与各自的读写标注,因此无法指定某个只读工具作为首次调用。建议先在有版本控制或备份的工程上尝试,并让 AI 在动手前先说明将执行的操作。
使用案例
案例一:用自然语言调整关卡与 Actor。打开编辑器后,在客户端里用一句话描述想要的场景改动,由服务器调用关卡、Actor 类别的工具在编辑器里执行。可期待的结果:这两个领域都在官方声明的自然语言可编程范围内。具体工具名与参数证据未列出,请以客户端实际工具列表为准。拿不准就先在测试工程里跑通,再回到正式工程。
案例二:用 YAML 流程引擎执行多步工作流。当单句指令不够、需要固定一串编辑器操作时,可以改用内置的 YAML 流程引擎来描述多步流程并交给服务器执行。可确认到:该引擎存在且面向多步工作流;YAML 的具体格式与示例证据未提供,动手前需查官方文档。写不出流程时,先用单句指令逐条验证,再串成流程。
使用边界
读写性质:官方明确给出的是读写访问,不是只读服务,且未提供任何撤销路径,不要把写操作当成可撤销;让 AI 动手前,先确认它将改动工程中的哪些内容。本地影响:安装会在工程内部署 C++ 桥接插件并启用 UE 插件;运行时客户端经 stdio 连接服务器,服务器再经 WebSocket JSON-RPC 连接编辑器内的插件。启用哪些类别由你在设置阶段自己决定,暂时用不到的类别可以不启用,暴露面随之更小。证据未说明它是否访问外部网络、是否有遥测或数据收集、是否需要凭证,也未说明多个客户端同时连接同一工程时的行为,这些均未确认;不能因为没找到说明就当作没有风险,建议把这些边界提前同步给每个会用它的人。