db-lyon/ue-mcp

解決的問題

UE-MCP 允許 AI 助手直接與 Unreal Engine 編輯器互動。它透過提供一個可程式化介面，消除將自然語言請求手動轉換為複雜編輯器操作的繁瑣工作，讓 AI 代理能直接建構關卡、撰寫材質、建立藍圖，並管理專案資源。

工作原理

本專案實作 Model Context Protocol (MCP)，在 AI 客戶端（如 Claude 或 Cursor）與 Unreal 編輯器之間建立橋樑。它由一個 TypeScript/Node.js 伺服器組成，透過 WebSocket/JSON-RPC 與安裝在 Unreal 編輯器內部的 C++ 橋接外掛程式通訊。此架構讓代理能在 24 個類別中執行超過 1,000 個動作，包含對 C++ 標頭檔與 INI 設定檔的直接檔案系統存取，即使編輯器未開啟也能進行專案探索。

適用對象

使用 Unreal Engine 5.4–5.8 的遊戲開發者與技術美術，希望自動化編輯器任務、透過 AI 產生程序化內容，或讓 AI 代理處理專案中重複性的技術設定者。

主要亮點

• 深度編輯器存取：可控制從 Niagara VFX 和 PCG 圖形到 Gameplay Ability System (GAS) 與 StateTree 的一切內容。
• YAML 流程：支援以 YAML 定義的多步驟工作流程，可熱重載並具備回滾功能。
• 原生工具集整合：封裝 Epic 官方 AI 工具集註冊表（UE 5.8+），將數百個官方工具作為代理動作呈現。
• 可擴展架構：可透過 npm 外掛系統新增動作。
• 安全防護機制：包含寫入保護與原始碼控制整合，防止 AI 代理意外覆蓋關鍵專案資料。