ue-official-mcp-5.8.0 — 选择正确的 UE 5.8.0 MCP 工具
官方虚幻引擎 5.8.0 MCP 服务器（ModelContextProtocol 插件）的操作路由。本技能是决策层，同时也是 references/ 下生成工具目录的索引。本技能中的所有架构均来自 UE 5.8.0 — 对于其他引擎版本（包括 UE 5.8 补丁版本），请使用对应的 ue-official-mcp-<X.Y.Z> 技能，因为 MCP 插件是实验性的，各版本间可能存在差异。
启用 AllToolsets 后，服务器通过 HTTP 暴露数十个工具集 / 数百个工具（支持流式传输，默认地址 http://127.0.0.1:8000/mcp）。编辑器必须运行，且调用在游戏线程上串行执行 — 切勿同时发起多个重叠调用。有关确切的实时数量和本参考生成时的快照日期，请参阅 references/index.md。
何时使用
在任何官方 MCP 编辑器自动化调用之前使用 — 用于选择哪个工具集/工具适合当前任务，然后阅读对应的 references/*.md 获取工具名称以及（在 references/toolsets/ 下的原始工具集文件中）完整的输入/输出 JSON 架构。直接从这些架构中调用 — 无需预先执行 describe_toolset。
如何调用
工具搜索已开启，因此 tools/list 仅显示 3 个元工具。在 Claude Code 会话中，它们以 mcp__<server-key>__* 的形式出现，其中 <server-key> 是 MCP 客户端 .mcp.json 中为服务器指定的名称（Epic 的示例设置使用 unreal-mcp → mcp__unreal-mcp__*）。三个元工具：
list_toolsets— 已启用工具集的名称 + 摘要。不要为了发现工具而调用它：请使用下面的路由表。describe_toolset(toolset_name)— 一个工具集中的工具（名称 + 架构）。仅当call_tool返回架构形式的错误（缺少/未知字段，类型错误）时，作为恢复路径调用，用于检查实时架构是否与文件有所差异。call_tool(name, arguments)— 调度一个工具；结果在同一轮返回。
流程：确定下面的领域 → 打开对应的 references/*.md 获取工具集和工具名称 → 打开原始 references/toolsets/<Name>.md 获取完整输入架构 → 直接 call_tool。如果调用返回架构形式的错误，重新执行 describe_toolset 以识别差异，然后重试 — 并考虑标记差异，以便维护者重新执行 sync。
路由 — 任务领域 → 参考
| 任务领域 | 参考 |
|---|---|
| 蓝图图形与逻辑（包括图形 DSL） | references/blueprint.md |
| 材质、材质实例、纹理 | references/material.md |
| Niagara（系统/发射器/模块/组件） | references/niagara.md |
| 动画、控制绑定、Sequencer | references/animation-sequencer.md |
| 静态/骨骼网格体、图元、PCG | references/mesh-geometry.md |
| 场景/关卡、Actor、资产、对象 | references/scene-actor.md |
| GAS（提示、属性集、ASC 检查）、GameplayTags | references/gas.md |
| UMG、StateTree、BehaviorTree、WorldConditions、Conversation | references/ui-state.md |
| 数据/曲线/字符串表、数据资产、DataRegistry | references/data-tables.md |
| 编辑器控制（控制台/PIE/视口）、日志、自动化测试、Slate 检查 | references/editor-automation.md |
| GameFeatures、插件、Dataflow、物理、SemanticSearch、AgentSkill | references/project-misc.md |
每个领域文件都链接到原始工具集目录（references/toolsets/），其中包含从 describe_toolset 逐字获取的每个工具的完整输入/输出 JSON 架构。
注意事项
- 实验性 — API 和数据格式在不同引擎版本间可能发生变化。本参考是
sync上次运行时的快照（参见references/index.md获取日期）。可乐观地信任架构；仅当call_tool返回架构形式的错误时，才通过describe_toolset进行恢复。 - 编辑器必须运行；调用是串行的 — 一次只能处理一个。
AgentSkillToolset.CreateSkill/UpdateSkill需要明确的用户权限（工具本身会提示）— 请勿未经提示就创建 AgentSkill。- 重新生成此参考：运行
uv run ue-mcp-skills sync --engine <X.Y.Z> --launch（探测实时编辑器并重写references/下的所有内容）。不带--launch时，将--endpoint指向一个已运行的编辑器。生成的文件带有戳记标头 — 请勿手动编辑它们；请改为编辑scripts/toolset_map.yaml中的领域分组。