Skip to main content
Glama

unreal-mcp

by runreal

unreal-mcp

MCP server for Unreal Engine that uses Unreal Python Remote Execution

hero

gif

Differences

This server does not require installing a new UE plugin as it uses the built-in Python remote execution protocol.

Adding new tools/features is much faster to develop since it does not require any C++ code.

It can support the full Unreal Engine Python API

Note

  • This is not an official Unreal Engine project.
  • Your AI agents or tools will have full access to your Editor.
  • Review any changes your Client suggests before you approve them.

Installation

Requirements
  • Unreal Engine 5.4+ (verified, may work with earlier versions)
  • Node.js with npx
  • MCP Client (Claude, Cursor, etc.)
  1. Setting up your Editor:
    • Open your Unreal Engine project
    • Go to Edit -> Plugins
    • Search for "Python Editor Script Plugin" and enable it
    • Restart the editor if prompted
    • Go to Edit -> Project Settings
    • Search for "Python" and enable the "Enable Remote Execution" option

enable plugin enable remote execution

  1. Set up your Client:
    • Edit your Claude (or Cursor) config
{ "mcpServers": { "unreal": { "command": "npx", "args": [ "-y", "@runreal/unreal-mcp" ] } } }

Available Tools

ToolDescription
set_unreal_engine_pathSet the Unreal Engine path
set_unreal_project_pathSet the Project path
get_unreal_engine_pathGet the current Unreal Engine path
get_unreal_project_pathGet the current Unreal Project path
editor_run_pythonExecute any python within the Unreal Editor
editor_list_assetsList all Unreal assets
editor_export_assetExport an Unreal asset to text
editor_get_asset_infoGet information about an asset, including LOD levels for StaticMesh and SkeletalMesh assets
editor_get_asset_referencesGet references for an asset
editor_console_commandRun a console command in Unreal
editor_project_infoGet detailed information about the current project
editor_get_map_infoGet detailed information about the current map/level
editor_search_assetsSearch for assets by name or path with optional class filter
editor_get_world_outlinerGet all actors in the current world with their properties
editor_validate_assetsValidate assets in the project to check for errors
editor_create_objectCreate a new object/actor in the world
editor_update_objectUpdate an existing object/actor in the world
editor_delete_objectDelete an object/actor from the world
editor_take_screenshotTake a screenshot of the Unreal Editor
editor_move_cameraMove the viewport camera to a specific location and rotation for positioning screenshots

Contributing

Please feel free to open issues or pull requests. Contributions are welcome, especially new tools/commands.

License MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

unreal-mcp

  1. Differences
    1. Note
      1. Installation
        1. Requirements
      2. Available Tools
        1. Contributing
          1. License MIT

        Related MCP Servers

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/runreal/unreal-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server