ue-official-mcp-5.8.0 — 選對 UE 5.8.0 MCP 工具
官方 Unreal Engine 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__<伺服器金鑰>__* 的形式出現，其中 <伺服器金鑰> 是 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 |
| 動畫、控制綁定、序列器 | 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中的領域分組。