安裝
"command": "npx",
"args": ["-y", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]適合誰
在 Windows(UE 5.4-5.8)或 Linux/macOS(UE 5.6+)上開發 Unreal Engine 專案、希望在 MCP 用戶端裡用自然語言操作編輯器的開發者與技術美術。官方聲稱它提供 29 個工具類別、2040+ 個動作,涵蓋藍圖、材質、關卡、Actor、動畫、VFX、地形、PCG、植被、音訊、UI、物理、導航、AI、網路、Sequencer、建置管線等領域,另有一個面向多步驟工作流程的 YAML 流程引擎。如果你常在編輯器裡做重複性的場景搭建與資產調整,或想讓 AI 接手一部分編輯器操作,它最對口;不打開編輯器的離線管線則用不上它。判斷方法很簡單:你的日常作業是否大部分在編輯器裡完成、是否願意讓模型直接改動專案資產,兩個都答是再往下走。
使用前提是本機工具鏈齊備:Node.js 18 或更新版本;引擎內建的 PythonScriptPlugin(隨引擎附帶,init 會替你啟用其餘所需外掛程式);以及必需的 C++ 工具鏈——Windows 需要帶 C++ 工作負載的 Visual Studio,macOS 需要 Xcode 命令列工具,因為橋接外掛程式會在編輯器首次啟動時編譯。缺少 C++ 工具鏈、或不願在專案裡部署 C++ 外掛程式的機器不適合;需要 epic 類別的功能必須用 UE 5.8+。另要注意外掛程式部署是按專案發生的:換專案時需要為新專案重新執行互動式 init 部署橋接外掛程式,並等待它在該專案編輯器首次啟動時編譯;換專案的完整步驟證據未說明,未確認。授權條款、費用與對專案規模的額外要求證據也未提及,需要自行確認。
3 分鐘完成第一次嘗試
建議主路徑:在 MCP 用戶端設定中以 npx 啟動伺服器並指向你的 .uproject。前提:已裝好上文列出的 UE、Node.js 18+ 與 C++ 工具鏈。
在用戶端的設定裡加入官方片段:
"command": "npx",
"args": ["-y", "ue-mcp@latest", "C:/path/to/MyGame.uproject"]
把 C:/path/to/MyGame.uproject 換成你的專案檔路徑。首次執行會進入互動式設定:自動偵測目前目錄的 .uproject,讓你選擇啟用哪些工具類別,把 C++ 橋接外掛程式部署進專案,啟用所需的 UE 外掛程式(Niagara、PCG、GAS 等),再偵測並設定你的 MCP 用戶端。
成功訊號:編輯器首次啟動完成外掛程式編譯後,用戶端裡能看到該伺服器的工具類別;對開啟的編輯器用自然語言下達一條指令,能觀察到編輯器內的實際回應。若類別遲遲不出現,先核對設定裡的專案路徑是否寫對,再等首次編譯結束。
注意:官方把它定位為給 AI 助理對編輯器的深度讀寫存取,寫入操作會直接改動專案內容;證據未列出個別工具名稱與各自的讀寫標註,因此無法指定某個唯讀工具作為首次呼叫。建議先在有版本控制或備份的專案上嘗試,並讓 AI 在動手前先說明將執行的操作。
使用案例
案例一:用自然語言調整關卡與 Actor。開啟編輯器後,在用戶端裡用一句話描述想要的場景改動,由伺服器呼叫關卡、Actor 類別的工具在編輯器裡執行。可期待的結果:這兩個領域都在官方聲稱的自然語言可程式化範圍內。具體工具名稱與參數證據未列出,請以用戶端實際工具清單為準。拿不準就先在測試專案裡跑通,再回到正式專案。
案例二:用 YAML 流程引擎執行多步驟工作流程。當單句指令不夠、需要固定一串編輯器操作時,可以改用內建的 YAML 流程引擎來描述多步驟流程並交給伺服器執行。可確認到:該引擎存在且面向多步驟工作流程;YAML 的具體格式與範例證據未提供,動手前需查官方文件。寫不出流程時,先用單句指令逐條驗證,再串成流程。
使用邊界
讀寫性質:官方明確給出的是讀寫存取,不是唯讀服務,且未提供任何復原路徑,不要把寫入操作當成可復原;讓 AI 動手前,先確認它將改動專案中的哪些內容。本機影響:安裝會在專案內部署 C++ 橋接外掛程式並啟用 UE 外掛程式;執行時用戶端經 stdio 連接伺服器,伺服器再經 WebSocket JSON-RPC 連接編輯器內的外掛程式。啟用哪些類別由你在設定階段自己決定,暫時用不到的類別可以不啟用,暴露面隨之更小。證據未說明它是否存取外部網路、是否有遙測或資料收集、是否需要憑證,也未說明多個用戶端同時連接同一專案時的行為,這些均未確認;不能因為沒找到說明就當作沒有風險,建議把這些邊界提前同步給每個會用它的人。