# Unreal Engine — AI Game Developer

为 Unreal Engine（5.5+）安装 AI Game Developer 插件。两种安装方式——Fab 和 unreal-mcp-cli——以及如何连接你的 AI 客户端并运行第一条提示词。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/engines/unreal)。

引擎 · 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 端点页面](https://ai-game.dev/mcp-endpoint-info)。

需要客户端配置片段（Claude、Cursor、Copilot、Gemini 等）？[查看 MCP 端点页面 →](https://ai-game.dev/mcp-endpoint-info)

03

## 配置你的 AI 智能体

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

你的 AI 智能体

**Claude Code**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Claude Code**：

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

**Claude Desktop**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Claude Desktop**：

`unreal-mcp-cli setup-mcp claude-desktop --path ./YourProject`

**Cursor**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Cursor**：

`unreal-mcp-cli setup-mcp cursor --path ./YourProject`

**VS Code (Copilot)**

在你的项目中运行以下命令，为 Unreal Engine 配置 **VS Code (Copilot)**：

`unreal-mcp-cli setup-mcp vscode-copilot --path ./YourProject`

**Visual Studio (Copilot)**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Visual Studio (Copilot)**：

`unreal-mcp-cli setup-mcp vs-copilot --path ./YourProject`

**Rider (Junie)**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Rider (Junie)**：

`unreal-mcp-cli setup-mcp rider-junie --path ./YourProject`

**GitHub Copilot CLI**

在你的项目中运行以下命令，为 Unreal Engine 配置 **GitHub Copilot CLI**：

`unreal-mcp-cli setup-mcp github-copilot-cli --path ./YourProject`

**Gemini**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Gemini**：

`unreal-mcp-cli setup-mcp gemini --path ./YourProject`

**Antigravity**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Antigravity**：

`unreal-mcp-cli setup-mcp antigravity --path ./YourProject`

**Cline**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Cline**：

`unreal-mcp-cli setup-mcp cline --path ./YourProject`

**Open Code**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Open Code**：

`unreal-mcp-cli setup-mcp open-code --path ./YourProject`

**Codex**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Codex**：

`unreal-mcp-cli setup-mcp codex --path ./YourProject`

**Kilo Code**

在你的项目中运行以下命令，为 Unreal Engine 配置 **Kilo Code**：

`unreal-mcp-cli setup-mcp kilo-code --path ./YourProject`

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

04

## 首次运行

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

1. 从编辑器的 **Tools** 菜单打开 AI Game Developer 窗口。
2. 选择 **Cloud** 并点击 **Authorize**，完成设备码流程。
3. 等待连接变为绿色，然后连接你的 AI 客户端。
4. 试试下面这样的提示词，看它在编辑器里如何执行。

示例提示词

```text
创建一个带静态网格立方体的新 Actor 蓝图，并在关卡中放置三个。
```

想要更多示例提示词和高效 AI 请求的写作范式？[查看 Unreal Engine 最佳实践 →](https://ai-game.dev/docs/best-practices/unreal)

[Unreal Engine 插件为你的 AI 客户端提供 **90 个 MCP 工具**。](https://ai-game.dev/docs/tools/unreal)

浏览 Unreal Engine 工具目录 →

想要更多工具？[浏览 Unreal Engine 扩展 →](https://ai-game.dev/docs/extensions/unreal)

---

Source (HTML): https://ai-game.dev/zh-hans/engines/unreal

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/engines/unreal