Unreal-MCP

概述

UnrealMCP通过CLI和MCP协议将虚幻引擎5与Claude Code、Cursor和Windsurf等AI编程助手连接。它全面支持对虚幻资产的控制，包括材质、蓝图、Niagara VFX、状态树、数据表、演员、性能分析等。该服务器通过运行在编辑器内的C++插件提供了13个类别的280多个命令，通过TCP进行通信。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• health_check

  Verify the Unreal Engine bridge is running

  试试:Check if Unreal MCP is running试试:Verify the bridge connection
• find_assets

  Search assets by class, path, or name

  试试:Find all materials in /Game/Materials试试:Search for blueprint assets
• create_blueprint

  Create a new blueprint asset

  试试:Create a new blueprint named BP_MyActor inheriting from Actor试试:Make a blueprint component for player movement
• build_material_graph

  Build a material graph with nodes and connections

  试试:Create a red material with base color node试试:Build a complex material with PBR nodes
• get_data_table_rows

  Retrieve rows from a data table

  试试:Get all rows from /Game/Data/DT_Items试试:Show the copper ore entry from items table
• spawn_actor

  Spawn an actor in the level

  试试:Spawn a cube at position [0,0,100]试试:Create a light actor at the player location
• performance_start_trace

  Start performance profiling trace

  试试:Begin profiling with CPU and GPU试试:Start performance capture for frame analysis
• create_input_action

  Create a new enhanced input action

  试试:Create a jump action with boolean value试试:Make a movement action with vector2D
• create_niagara_system

  Create a new Niagara VFX system

  试试:Create a spark system from the sparks template试试:Make a new Niagara system for fire effects
• create_statetree

  Create a new StateTree asset

  试试:Create an enemy AI StateTree试试:Make a patrol behavior StateTree
• get_widget_tree

  Retrieve widget blueprint tree structure

  试试:Show the structure of the HUD widget试试:Get all elements from the main menu UI
• execute_python

  Execute Python code in the editor

  试试:Print all loaded actors试试:Get the current world time

可对比工具

安装

# 安装CLI工具
npm install -g unrealcli

# 在UE5项目中设置
cd YourProject/
ue-cli init
ue-cli doctor

# 克隆插件到项目
git clone https://github.com/aadeshrao123/Unreal-MCP.git Plugins/UnrealMCP

# 安装Python服务器
pip install unrealmcp

# 添加到Claude Desktop配置（示例）
{
  "mcpServers": {
    "unreal": {
      "command": "unrealmcp"
    }
  }
}

FAQ

这个支持虚幻引擎4吗？

目前支持虚幻引擎5（已在5.7上测试，可能在更早的5.x版本上工作）。

我可以将它与不支持MCP的AI工具一起使用吗？

是的，它提供了CLI模式，可以通过bash工具与Claude Code等工具一起使用。

Unreal-MCP 对比