Unreal MCP

Unreal MCP 是 AI Game Developer 的 Unreal Engine 外掛。它讓 Claude Code、Cursor、GitHub Copilot、Codex 或 Gemini 等 AI 代理直接在 Unreal 編輯器內工作：查詢與變更 actor、元件、資產與關卡，撰寫並編譯 Blueprint，編輯並編譯 C++，執行編輯器 Python，以及擷取可供它查看的截圖。你以自然語言描述需求，代理便透過 Model Context Protocol（MCP）呼叫編輯器的工具。

本 wiki 說明如何安裝外掛、連接你的 AI 用戶端，以及如何在 Unreal 編輯器中讓 AI 產出有用的結果。外掛目前為 beta；現行版本是 0.26.2。

各部件的組合方式#

一套 Unreal MCP 環境由四個部分組成。了解這四個部分，能讓設定與疑難排解輕鬆許多。

• Unreal MCP 外掛（UnrealMCP）。這是一個 C++ 編輯器外掛，安裝在專案的 Plugins/ 資料夾中。它會註冊各項 AI 工具，並在編輯器中加入 AI Game Developer 視窗。
• 橋接程式（unreal-mcp-bridge）。Unreal 編輯器是以 C++ 撰寫，因此 .NET 的 MCP 主機會以小型輔助程序的形式，在編輯器旁執行。外掛會自動啟動它，並透過受權杖保護的本機連線與之溝通。封裝發行版已內含橋接程式，因此你不需要安裝 .NET。
• MCP 伺服器。橋接程式預設會連線到託管於 ai-game.dev 的伺服器（Cloud 模式）。你也可以改為在自己的機器上執行共用的本機伺服器 gamedev-mcp-server（Custom 模式）。
• 你的 AI 用戶端。任何 MCP 用戶端都會連線到同一個伺服器，並透過它連到你的編輯器。

有兩項工具可協助你完成這項設定：

• AI Game Dev 桌面應用程式會替你將外掛安裝到 Unreal 專案中，並可開啟編輯器。不需要 Node.js。請參閱應用程式 wiki。
• unreal-mcp-cli，一個發佈於 npm 的跨平台命令列工具。它會安裝並更新外掛、讓你登入、寫入 MCP 用戶端設定、開啟編輯器，並可從終端機或 CI 執行工具。

AI 代理能做什麼#

外掛內含 7 個工具家族、共 27 項工具。大多數編輯器資料都透過 RQL 處理，這是一套適用於整個編輯器的查詢語言，而不是每個操作各用一項工具：

• RQL（rql-query、rql-mutate、rql-schema）：尋找並變更 actor、元件、資產、關卡、DataTable、gameplay tag、Project Settings、Blueprint 圖表、Widget Blueprint 與 Level Sequence。
• Blueprints：建立、編輯並編譯 Blueprint，並提供代理可據以修正的結構化錯誤清單。
• C++ 原始碼：讀取、建立範本、編輯並編譯專案 C++（Live Coding 或 Unreal Build Tool）。
• Python：以完整的 unreal 編輯器 API 執行 Python。
• 截圖：視埠、遊戲視角、攝影機與隔離 actor 的擷取畫面。
• Console 與工具清單輔助功能。

六個選用擴充功能分別新增 Control Rig、Enhanced Input、Gameplay Ability System、Landscape 與 Water、Niagara 以及 PCG 支援。你也可以從任何 Unreal 外掛註冊自己的工具。

Wiki 頁面#

接下來該看什麼#

• 第一次來嗎？請先閱讀安裝，接著看開始使用。
• 想要精簡版嗎？Unreal Engine 安裝頁面與快速入門涵蓋了重點。
• 想了解工具細節嗎？請瀏覽 Unreal 工具目錄 和 Unreal 最佳實務。
• 同時使用其他引擎嗎？請參閱 Unity wiki 和 Godot wiki。這三個外掛共用同一個伺服器、帳號與 AI 用戶端。