unreal-mcp

Overview

This MCP server provides comprehensive tools for controlling Unreal Engine through natural language commands via AI assistants like Cursor, Windsurf and Claude Desktop. It enables actor management, blueprint development, node graph manipulation, and editor control. The project consists of a C++ plugin integrated with Unreal Editor and a Python MCP server that implements the Model Context Protocol.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• create_actor

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

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

  Delete actors from the current level

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

  Set actor properties like position, rotation, and scale

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

  Query properties and find actors by name

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

  List all actors in the current level

  Try:Show me all actors in the levelTry:List only actors of type StaticMesh
• create_blueprint_class

  Create new Blueprint classes with custom components

  Try:Create a new Blueprint for a doorTry:Generate a Blueprint for an enemy character
• add_blueprint_component

  Add and configure components to Blueprints

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

  Compile Blueprint scripts to validate and build them

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

  Add nodes to Blueprint graphs

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

  Create variables with custom types in Blueprints

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

  Focus viewport on specific actors or locations

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

  Spawn Blueprint actors in the world

  Try:Spawn 'enemy_blueprint' at originTry:Create 5 instances of 'pickup_blueprint'

Comparable tools

Installation

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

FAQ

Is this production ready?

No, this project is currently in EXPERIMENTAL status. Breaking changes may occur without notice, features may be incomplete, and production use is not recommended at this time.

Which Unreal Engine versions are supported?

This project supports Unreal Engine 5.5 and newer versions.

How do I connect the Python server to the Unreal Engine plugin?

The Python server connects to the C++ plugin via TCP socket on port 55557. The plugin acts as a native TCP server for MCP communication.

Compare unreal-mcp with