SuperAPI AI 工具集

unreal-mcp

智能体与模型

查看项目

更新于 10-16 02:32

技能介绍

用途:通过 Hermes 连接运行在 Unreal Editor 进程内的官方实验性 Unreal MCP 插件,用自然语言完成关卡搭建、Actor 增删移动、灯光氛围、材质实例、相机取景、截图渲染、资产导入、场景检查与自动化测试等编辑器操作。不适用于 DCC 式网格建模雕刻(应在 Blender 建模后导入),也不用于编辑 Unreal C++ 项目源码。

主要能力:默认工具搜索模式下,工具以 mcp_unreal_engine_list_toolsets、mcp_unreal_engine_describe_toolset、mcp_unreal_engine_call_tool 三个元工具暴露,需按 list_toolsets → describe_toolset → call_tool 顺序发现并调用;工具集名称须用完整限定名,工具名用短名。

使用方式:编辑器侧需 Unreal Editor 5.8+ 并打开项目,在 Edit > Plugins 启用 Unreal MCP 与 AllToolsets,在 Editor Preferences 的 Model Context Protocol 中启用 Auto Start Server(默认 http://127.0.0.1:8000/mcp),或手动执行 ModelContextProtocol.StartServer。Hermes 侧执行 hermes mcp install unreal-engine,须在编辑器与服务器已启动时运行。每次会话先启动编辑器并确认服务器,再开 Hermes 会话,工具注册为 mcp_unreal_engine_*。

限制:服务器在游戏线程串行执行,禁止并行或批量调用,每次调用会冻结编辑器 UI;模态对话框会阻塞调用;长操作可能超过默认 120 秒超时,可在 ~/.hermes/config.yaml 调整 mcp_servers.unreal-engine.timeout;工具架构可能随引擎版本变化,以 describe_toolset 实时结果为准;服务器仅限本机回环、无认证,不应扩大绑定范围;插件为实验性,数据经插件传给 LLM 服务属 UE EULA 许可技术,用户需自行确保提供商不用于训练。编辑为内存态,需频繁保存,MCP 编辑不可靠撤销。