本页由英文机器翻译而成。阅读英文原文。

引擎 · Unreal Engine

Unreal Engine可用

将 Unreal-MCP 插件安装到你的 C++ 项目中,并用 AI 驱动编辑器。

Unreal Engine 5.5+已在 5.7 上测试C++ 项目
01

安装插件

两种方式把插件装进你的项目——选适合你工作流的那种。

推荐

CLI

通过 npm 上的 unreal-mcp-cli 工具安装。目前适用于任何 UE 5.5+ C++ 项目。

1安装 CLI

从 npm 全局安装 unreal-mcp-cli。

npm install -g unreal-mcp-cli
2安装插件

将 Unreal-MCP 插件安装到你的项目中。

unreal-mcp-cli install-plugin ./YourProject
3授权

登录,以便插件通过 ai-game.dev 连接。

unreal-mcp-cli login ./YourProject
4打开项目

在 Unreal 编辑器中打开项目。

unreal-mcp-cli open ./YourProject
即将推出

Fab / Epic 商城

通过 Epic Games Launcher 从 Fab 安装 Unreal-MCP——已预编译,无需构建。尚未在 Fab 上线;上线前请使用目前可用的 CLI 方式。

1从 Fab 安装

通过 Epic Games Launcher 从 Fab 安装 Unreal-MCP。

2启用插件

在编辑器中打开 Edit → Plugins,找到 Unreal-MCP 并启用它。

3打开项目

重新打开项目——插件已预编译,无需构建。

02

连接

通过托管的云端端点运行,或指向你自己的服务器。

云端

默认

使用设备码 OAuth 流程通过 ai-game.dev 连接——无需手动复制令牌。在 AI Game Developer 窗口中选择 Cloud,点击 Authorize,然后在浏览器中批准设备码。可跨防火墙使用,并提供用量分析。这是默认方式,也是我们为大多数用户推荐的方式。

自定义

更想全部在本地运行?把插件指向你自己的 gamedev-mcp-server 实例,而不是托管端点。这样你的 AI 客户端会直接与本机通信。各客户端的配置片段见 MCP 端点页面。

需要客户端配置片段(Claude、Cursor、Copilot、Gemini 等)?查看 MCP 端点页面 →

03

配置你的 AI 智能体

选择你使用的 AI 智能体,复制把它接入 Unreal Engine MCP 服务器的 unreal-mcp-cli 命令。

你的 AI 智能体

在你的项目中运行以下命令,为 Unreal Engine 配置 Claude Code:

unreal-mcp-cli setup-mcp claude-code --path ./YourProject

配置后请重启你的智能体。新的 MCP 服务器只有在智能体完全重启后才会被加载——请彻底退出并重新打开(仅重载窗口不够)。

04

首次运行

打开窗口,完成授权,然后试试你的第一条提示词。

  1. 从编辑器的 Tools 菜单打开 AI Game Developer 窗口。
  2. 选择 Cloud 并点击 Authorize,完成设备码流程。
  3. 等待连接变为绿色,然后连接你的 AI 客户端。
  4. 试试下面这样的提示词,看它在编辑器里如何执行。
示例提示词
创建一个带静态网格立方体的新 Actor 蓝图,并在关卡中放置三个。

想要更多示例提示词和高效 AI 请求的写作范式?查看 Unreal Engine 最佳实践 →

Unreal Engine 插件为你的 AI 客户端提供 90 个 MCP 工具。

浏览 Unreal Engine 工具目录 →

想要更多工具?浏览 Unreal Engine 扩展 →