unreal-mcp

概述

这个 MCP 服务器通过自然语言命令，让 AI 助手（如 Cursor、Windsurf 和 Claude Desktop）控制虚幻引擎。它提供演员管理、蓝图开发、节点图操作和编辑器控制等功能。项目包含一个与虚幻编辑器集成的 C++ 插件和一个实现模型上下文协议的 Python MCP 服务器。

试试问 AI

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

• create_actor

  Create actors (cubes, spheres, lights, cameras, etc.) in the Unreal Engine scene

  试试:Create a red cube at position (100, 200, 50)试试:Add a spotlight pointing down
• delete_actor

  Delete actors from the current level

  试试:Remove the actor named 'my_cube'试试:Delete all actors with 'temp_' prefix
• set_actor_transform

  Set actor properties like position, rotation, and scale

  试试:Move actor 'my_light' to coordinates (0, 100, 200)试试:Rotate camera to face north
• query_actor_properties

  Query properties and find actors by name

  试试:What are the properties of actor 'main_camera'?试试:Find all lights in the scene
• list_actors

  List all actors in the current level

  试试:Show me all actors in the level试试:List only actors of type StaticMesh
• create_blueprint_class

  Create new Blueprint classes with custom components

  试试:Create a new Blueprint for a door试试:Generate a Blueprint for an enemy character
• add_blueprint_component

  Add and configure components to Blueprints

  试试:Add a mesh component to 'player_blueprint'试试:Configure a camera component with 90° field of view
• compile_blueprint

  Compile Blueprint scripts to validate and build them

  试试:Compile 'weapon_blueprint'试试:Check for errors in 'vehicle_blueprint'
• add_blueprint_node

  Add nodes to Blueprint graphs

  试试:Add a BeginPlay event node to 'character_blueprint'试试:Create a function call for 'fire_weapon'
• add_blueprint_variable

  Create variables with custom types in Blueprints

  试试:Add a health variable with default value 100试试:Create a speed variable of type float
• focus_viewport

  Focus viewport on specific actors or locations

  试试:Focus camera on 'player_character'试试:Look at coordinates (500, 0, 300)
• spawn_blueprint_actor

  Spawn Blueprint actors in the world

  试试:Spawn 'enemy_blueprint' at origin试试:Create 5 instances of 'pickup_blueprint'

可对比工具

安装

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "<path/to/the/folder/PYTHON>",
        "run",
        "unreal_mcp_server.py"
      ]
    }
  }
}

FAQ

这个项目是否可用于生产环境？

否，此项目目前处于 EXPERIMENTAL 状态。可能会发生不通知的破坏性更改，功能可能不完整，目前不建议在生产环境中使用。

支持哪些虚幻引擎版本？

此项目支持虚幻引擎 5.5 及更高版本。

如何将 Python 服务器连接到虚幻引擎插件？

Python 服务器通过端口 55557 上的 TCP 套接字连接到 C++ 插件。插件充当 MCP 通信的原生 TCP 服务器。

unreal-mcp 对比