unreal-mcp

The Unreal MCP integration provides comprehensive tools for controlling Unreal Engine through natural language. It allows for actor management, blueprint development, blueprint node graph manipulation, and editor control. These capabilities are accessible through natural language commands via AI assistants, making it easy to automate and control Unreal Engine workflows. The project is in an experimental state, meaning that the API, functionality, and implementation details are subject to significant changes. Users are encouraged to test and provide feedback, but should be aware that breaking changes may occur without notice, features may be incomplete or unstable, and documentation may be outdated or missing. Production use is not recommended at this time.

Features

• Actor Management: Create and delete actors, set actor transforms, query actor properties, and list all actors in the current level.
• Blueprint Development: Create new Blueprint classes, add and configure components, set component properties, compile Blueprints, and create input mappings.
• Blueprint Node Graph: Add event nodes, create function call nodes, add variables, create references, and manage nodes in the graph.
• Editor Control: Focus viewport on specific actors or locations, control viewport camera orientation and distance.

MCP Tools

• {'Sample Project (MCPGameProject)': 'Based off the Blank Project, but with the UnrealMCP plugin added.'}
• {'Plugin (UnrealMCP)': 'Native TCP server for MCP communication, integrates with Unreal Editor subsystems, implements actor manipulation tools.'}
• {'Python MCP Server': 'Manages TCP socket connections, handles command serialization and response parsing, provides error handling and connection management.'}

Usage with Different Platforms

MCP Configuration

Use the following JSON for your mcp configuration based on your MCP client.

script

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