项目简介

Unreal Engine MCP Server 是一个基于Model Context Protocol构建的服务器，专门用于让AI助手与虚幻引擎编辑器进行交互。它通过TypeScript构建的服务器端和C++插件，为AI应用提供了全面的虚幻引擎控制能力。

主要功能

资源管理：浏览、导入、复制、重命名、删除资源，创建材质
角色控制：生成、删除、变换、物理效果、标签、组件管理
编辑器控制：PIE会话、相机控制、视口截图、书签管理
关卡管理：加载/保存关卡、流送、世界分区、数据层
动画与物理：动画蓝图、状态机、布娃娃系统、车辆、约束
视觉效果：Niagara粒子系统、GPU模拟、程序化效果、调试形状
Sequencer：电影序列、时间线控制、相机动画、关键帧
蓝图编辑：蓝图、Niagara、材质、行为树的图形操作
音频系统：音效提示、音频组件、混音设置、环境音效

安装步骤

前置要求

Node.js 18+ 版本
虚幻引擎 5.0-5.7 版本

1. 安装MCP服务器

推荐方式（使用NPX）：

npx unreal-engine-mcp-server

或从源码构建：

git clone https://github.com/ChiR24/Unreal_mcp.git
cd Unreal_mcp
npm install
npm run build
node dist/cli.js

2. 安装虚幻引擎插件

将 'Unreal_mcp/plugins/McpAutomationBridge/' 文件夹复制到你的虚幻项目中的 'Plugins/' 目录下，然后重新生成项目文件。

3. 启用必要插件

在虚幻编辑器中通过"编辑 → 插件"启用以下插件：

MCP Automation Bridge（核心自动化操作）
Editor Scripting Utilities（资源/角色子系统操作）
Sequencer（Sequencer工具）
Level Sequence Editor（序列操作）
Control Rig（动画物理操作）

4. 配置MCP客户端

在Claude Desktop或Cursor的配置文件中添加：

使用NPX方式：

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": ["unreal-engine-mcp-server"],
      "env": {
        "UE_PROJECT_PATH": "C:/路径/到/你的项目"
      }
    }
  }
}

使用源码构建方式：

{
  "mcpServers": {
    "unreal-engine": {
      "command": "node",
      "args": ["路径/到/Unreal_mcp/dist/cli.js"],
  "env": {
    "UE_PROJECT_PATH": "C:/路径/到/你的项目",
    "MCP_AUTOMATION_PORT": "8091"
    }
  }
}

环境变量配置

UE_PROJECT_PATH="C:/路径/到/你的项目"
MCP_AUTOMATION_HOST="127.0.0.1"
LOG_LEVEL="info"

基本使用方法

安装配置完成后，AI助手可以通过MCP协议调用各种虚幻引擎功能，如创建新关卡、生成角色、设置材质、控制动画等，实现智能化的虚幻引擎开发工作流程。

关键词