适合谁
- 使用 Unreal Engine 5 进行游戏开发、关卡设计、动画、特效或技术美术的团队。
- 需要通过 AI 执行重复编辑器操作和内容生产任务的用户。
- 具备 Unreal 项目、插件和本地开发环境管理能力的用户。
U
53FMRS · D
这是一个面向 Unreal Engine 5 自动化的功能广泛的 MCP 服务器，覆盖从资产和蓝图到环境、AI、特效、音频、网络与电影制作的工作流。它需要安装 Unreal 插件并授予项目级编辑能力；局域网访问应谨慎配置。
Unreal Engine MCP Server 是一个使用 TypeScript 和 C++ 构建的 MCP 服务器，通过原生 C++ Automation Bridge 插件让 AI 助手自动化操作 Unreal Engine。它提供 23 个工具，覆盖资产、演员、编辑器、关卡、蓝图、动画、物理、特效、AI、音频、网络和 Sequencer 等工作流。服务器支持 stdio，以及插件提供的原生 Streamable HTTP 传输。
工具能力
manage_asset
管理资产、材质、渲染目标、行为树和蓝图结构体。
manage_blueprint
管理蓝图、SCS 组件、图表、UMG 小部件、布局、绑定和动画。
control_actor
生成、删除和变换演员，并管理物理、标签和组件。
control_editor
控制 PIE 会话、摄像机、视口、截图和书签。
manage_level
加载和保存关卡，并管理关卡流送与光照。
system_control
执行 UBT、测试、日志、项目设置、CVar 和 Python 操作。
inspect
检查 Unreal 对象。
manage_tools
在运行时动态启用或禁用工具。
build_environment
管理地形、植被、程序化环境、光照以及样条道路、河流和围栏。
manage_level_structure
管理关卡、子关卡、World Partition、流送、数据层、HLOD 和体积。
manage_geometry
使用 Geometry Script 创建和编辑程序化网格。
manage_pcg
管理 PCG 图资产、节点、引脚连接、执行、分区网格大小和节点设置。
animation_physics
管理动画蓝图、骨架、插槽、物理资产、布料、载具、布娃娃、Control Rig 和 IK。
manage_effect
管理 Niagara、粒子、调试形状和 GPU 模拟。
manage_gas
管理 Gameplay Ability System 的能力、效果和属性。
manage_character
创建角色并管理移动与高级运动。
manage_combat
管理武器、投射物、伤害和近战系统。
manage_ai
管理 AI 控制器、行为树、EQS、感知、State Tree、Smart Objects 和导航。
manage_inventory
管理物品、装备、战利品表和制作系统。
manage_interaction
管理可交互对象、可破坏物和触发器。
manage_audio
管理音频资产、组件、Sound Cue、MetaSound 和衰减。
manage_sequence
管理 Sequencer、电影制作、Movie Render Queue、媒体、Take Recorder 和回放。
manage_networking
管理复制、RPC、网络预测、会话、分屏、局域网、语音、游戏框架和输入映射。
安装接入
使用 TypeScript Bridge 时，先准备 Node.js 18 或更高版本，并将 MCP Automation Bridge 插件安装到 Unreal 项目中。可使用 npx unreal-engine-mcp-server，或克隆仓库后执行 npm install、npm run build 和 node dist/cli.js。配置 UE_PROJECT_PATH 指向 Unreal 项目路径。也可以启用插件内置的 Native MCP，将客户端连接到 http://localhost:3000/mcp。
claude_desktop_config.json
{"mcpServers":{"unreal-engine":{"command":"npx","args":["unreal-engine-mcp-server"],"env":{"UE_PROJECT_PATH":"C:/Path/To/YourProject"}}}}
选型与风险
不适合谁
- 不使用 Unreal Engine 的项目。
- 只使用蓝图且无法安装预构建插件或代码插件的环境。
- 需要远程公网暴露而没有网络安全配置的场景。
所需权限
- 需要访问并操作指定的 Unreal 项目。
- 需要安装并运行 MCP Automation Bridge 插件及其所需的 Unreal 插件。
- 部分功能需要项目启用 Python、Editor Scripting Utilities、Niagara、Gameplay Abilities、Smart Objects 等插件。
- TypeScript Bridge 需要 Node.js 18 或更高版本。
风险与副作用
- 服务器可以修改资产、演员、关卡、项目设置和其他游戏开发内容。
- 启用非回环地址会将自动化桥接暴露给局域网；应仅在受信任网络中使用，并启用能力令牌认证。
- 错误的控制台命令、脚本或自动化操作可能造成项目内容或编辑器状态改变。
- 预构建插件二进制文件与特定 Unreal Engine 版本绑定。
常见排障
- 确认 UE_PROJECT_PATH 指向有效的 .uproject 文件或项目路径。
- 确认 MCP Automation Bridge 已安装、编译并在 Unreal Editor 中启用。
- 代码项目若出现缺少模块错误，应通过 Visual Studio 或 Xcode 构建；蓝图项目需要代码目标或预构建插件。
- 检查 MCP_AUTOMATION_HOST、MCP_AUTOMATION_PORT 以及连接和请求超时设置。
- Native MCP 模式下检查编辑器状态栏和 LogMcpNativeTransport 输出。
- 确认所需的 Unreal 插件已启用，并检查工具对应的可选插件。
使用场景
通过自然语言自动化 Unreal Engine 编辑器和游戏开发流程。
创建和管理资产、蓝图、关卡、环境、特效、动画、AI 和音频。
控制 PIE、Sequencer、电影渲染和编辑器检查流程。
支持客户端
Claude Desktop完整支持
Cursor完整支持
Claude Code完整支持