SuperAPI AI 工具集

unreal-mcp

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:该技能让 AI 通过 unreal-mcp MCP 服务器接入正在运行的 Unreal Editor,直接检查和修改实时编辑器状态,而不是让用户手动操作。连接在安装引擎可选代理时可能显示为 unreal-mcp-proxy,Unreal 工具应使用该连接。

主要能力:服务器通过 Unreal 的 ToolsetRegistry 注册了 30 多个工具集、数百个工具,涵盖 actors、blueprints、materials、Niagara、Sequencer、Control Rigs、GAS、automation tests、Live Coding 等。默认开启工具搜索,会话中只暴露 list_toolsets、describe_toolset、call_tool 三个元工具;具体工具如 BlueprintTools.create 或 SequencerTools.create_level_sequence 不在 tools/list 中,而是由 call_tool 在服务端派发。

使用方式:先调用 list_toolsets 查看已注册工具集,再用 describe_toolset 读取候选工具集的 schema;若已知所需工具集可直接 describe_toolset。随后用 call_tool 传入 toolset_name、tool_name 和符合 schema 的 arguments 调用,结果在同一轮返回。省略 toolset_name 的顶层派发仅用于直接注册在 MCP 服务器上的工具,对 call_tool 本身会被拒绝。项目或插件还可通过 AgentSkillToolset 注册 Agent Skills,用 ListSkills 查看、GetSkills 加载,相关技能说明优先于通用默认做法。

限制与安全:工具缺失不代表编辑器已停止,需检查 unreal-mcp 或 unreal-mcp-proxy 连接并参考 references/operations.md;unreal_mcp_status 只报告代理会话状态,不代表当前可达性,恢复需用只读 Unreal 工具调用验证。批量修改前应让用户保存项目,修改后再保存一次,MCP 编辑并非总能撤销。C++ 或着色器编译进行中时调用会挂起或失败,可用 LiveCodingToolset.CompileLiveCoding 并等待结果。并发请求的完成顺序不保证,依赖调用和影响同一资产的修改应串行。许多工具返回的状态可能无异常地表示失败,必须检查结果。PIE 运行时编辑器专用工具行为不同,结果异常时应检查并停止 PIE。首次配置见 references/setup.md。配套技能 create-toolset 用于编写工具集,unreal-skill 用于创建或审查 Agent Skill。