unreal-mcp

Unreal MCP Server

Unreal Editor inspection and editing tools become available to AI clients through unreal-mcp, using Python remote execution. It serves Unreal developers who want agents to examine assets and levels, modify actors, run Python, and capture editor views.

Server facts

unreal-mcp

Project

Author
runreal
License
MIT
Category
Games & 3D

Tech

Runtime / language
python
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
116
Last commit
Data as of

Tags

  • Python
  • Typescript
  • Unreal Engine
  • mcp
  • modelcontextprotocol
  • unreal

Overview

Unreal project assets, level contents, and viewport operations are exposed to MCP clients through unreal-mcp. Developers can search assets using names or paths, narrow results by class, inspect mesh LOD metadata, and find assets that reference a selected asset. Other tools report project details, map information, and world actors with their properties and transforms. Asset validation reports errors, while export tools provide another way to examine asset content. Engine and project paths can also be set or retrieved through the tool interface.

For editing workflows, the tools can create, update, or delete objects and actors, execute Python inside the editor, and issue Unreal console commands. Camera positioning and screenshot capture support inspecting the current editor view. The connection uses Unreal’s built-in Python remote execution mechanism rather than an additional UE plugin, but the Python Editor Script Plugin and remote execution setting must be enabled. The project is unofficial, and its documentation warns that connected agents receive full editor access; proposed changes should be reviewed before approval.

unreal-mcp setup notes

  • unreal-mcp records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers