Unreal Engine

v0.4.6Developer Toolsstable

Enables AI assistants to control Unreal Engine via Remote Control API for game development automation, including asset management, actor control, level editing, animation, physics, visual effects, and cinematics creation through natural language.

mcpmcp-serverunreal-engineunreal-engine-5modelcontextprotocol
Share:
636
Stars
0
Downloads
0
Weekly
0/5

What is Unreal Engine?

Unreal Engine is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to control unreal engine via remote control api for game development automation, including asset management, actor control, level editing, animation, physics, visual effects, and...

Enables AI assistants to control Unreal Engine via Remote Control API for game development automation, including asset management, actor control, level editing, animation, physics, visual effects, and cinematics creation through natural language.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • manage_asset
  • control_actor
  • control_editor
  • manage_level
  • animation_physics

Use Cases

Asset library utility for browsing, importing, and bootstrapping simple materials. Use it when you need to: - explore project content (/Content automatically maps to /Game). - import FBX/PNG/WAV/EXR
Viewport actor toolkit for spawning, removing, or nudging actors with physics forces. Use it when you need to: - drop a class or mesh into the level (classPath accepts names or asset paths). - delete
Editor session controls for PIE playback, camera placement, and view modes. Use it when you need to: - start or stop Play In Editor. - reposition the active viewport camera. - switch between Lit/Unli
Level management helper for loading/saving, streaming, light creation, and lighting builds. Use it when you need to: - open or save a level by path. - toggle streaming sublevels on/off. - spawn a lig
Animation and physics rigging helper covering Anim BPs, montage playback, and ragdoll setup. Use it when you need to: - generate an Animation Blueprint for a skeleton. - play a montage/animation on a
ChiR24

Maintainer

LicenseMIT
Languagec++
Versionv0.4.6
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y unreal-engine-mcp-server

Manual Installation

npx -y unreal-engine-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Unreal Engine

The Unreal Engine MCP Server connects AI assistants to Unreal Engine 5 via the Remote Control API and a C++ plugin called McpAutomationBridge, exposing 23 tools that cover asset management, actor control, Blueprint editing, level management, animation, physics, visual effects, AI, cinematics, and more. It enables natural language control over game development workflows — from spawning actors and importing meshes to triggering Play-In-Editor sessions and building lighting — all without leaving your AI assistant. Teams use it to automate repetitive UE5 tasks, prototype game mechanics faster, and let AI handle editor operations through conversational commands.

Prerequisites

  • Unreal Engine 5 installed (UE 5.1 or later recommended)
  • Node.js 18 or later for the TypeScript bridge (optional if using native HTTP plugin)
  • The McpAutomationBridge plugin copied into your UE5 project's Plugins folder
  • An MCP-compatible AI client such as Claude Desktop or Claude Code
  • Remote Control API plugin enabled in your UE5 project
1

Install the McpAutomationBridge plugin

Copy the plugin from the repository into your Unreal Engine project's Plugins directory, then enable it in the Unreal Editor under Edit > Plugins.

cp -r Unreal_mcp/plugins/McpAutomationBridge/ YourProject/Plugins/
2

Enable the plugin and configure the bridge in Unreal Editor

Open Edit > Project Settings > MCP Automation Bridge and confirm the host and port settings. The built-in HTTP server starts automatically when the plugin is active.

3

Install and start the TypeScript bridge (alternative)

If you prefer the npm-based bridge instead of the native plugin, clone the repository and run the server with npx.

npx unreal-engine-mcp-server
# Or from source:
git clone https://github.com/ChiR24/Unreal_mcp.git
cd Unreal_mcp && npm install && npm run build
node dist/cli.js
4

Set environment variables for the bridge

Configure the bridge connection using environment variables. UE_PROJECT_PATH is required; the other variables default to localhost:8091.

export UE_PROJECT_PATH=/path/to/YourProject/YourProject.uproject
export MCP_AUTOMATION_HOST=127.0.0.1
export MCP_AUTOMATION_PORT=8091
export LOG_LEVEL=info
5

Add the server to your MCP client configuration

Register the Unreal Engine MCP server in claude_desktop_config.json. The server uses HTTP transport and connects to the running UE5 bridge.

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": ["-y", "unreal-engine-mcp-server"],
      "env": {
        "UE_PROJECT_PATH": "/path/to/YourProject.uproject",
        "MCP_AUTOMATION_HOST": "127.0.0.1",
        "MCP_AUTOMATION_PORT": "8091"
      }
    }
  }
}
6

Open UE5 project and verify the connection

Launch your Unreal Engine project. Once the McpAutomationBridge plugin is active and the MCP client is connected, ask Claude to list available actors or assets to confirm the integration works.

Unreal Engine Examples

Client configuration

claude_desktop_config.json entry for the Unreal Engine MCP server using the npm package.

{
  "mcpServers": {
    "unreal-engine": {
      "command": "npx",
      "args": ["-y", "unreal-engine-mcp-server"],
      "env": {
        "UE_PROJECT_PATH": "/Users/you/Projects/MyGame/MyGame.uproject",
        "MCP_AUTOMATION_HOST": "127.0.0.1",
        "MCP_AUTOMATION_PORT": "8091",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Prompts to try

Natural language prompts that map to real UE5 operations through the 23 exposed tools.

- "Spawn a character Blueprint at coordinates (100, 200, 50) and enable physics simulation"
- "Import the FBX mesh at /Game/Models/Vehicle and auto-create a basic material for it"
- "Start Play-In-Editor and switch the viewport to Unlit mode"
- "Load the level called MainMap and place a point light at the origin"
- "Play a Niagara particle effect at the player's location and take a screenshot"

Troubleshooting Unreal Engine

Connection refused when the MCP client tries to reach the UE5 bridge

Ensure the McpAutomationBridge plugin is enabled and the UE5 project is open and running in the editor. Check that MCP_AUTOMATION_PORT matches the port configured in Project Settings > MCP Automation Bridge.

manage_asset returns no results for a known asset path

Asset paths must use the /Game/ prefix (e.g. /Game/Characters/Hero). The /Content/ folder on disk maps to /Game/ in Unreal's content browser. Verify the path using the content browser before querying.

LAN access from another machine fails

Set MCP_AUTOMATION_ALLOW_NON_LOOPBACK=true and change MCP_AUTOMATION_HOST to 0.0.0.0 in your environment variables, then restart the bridge.

Frequently Asked Questions about Unreal Engine

What is Unreal Engine?

Unreal Engine is a Model Context Protocol (MCP) server that enables ai assistants to control unreal engine via remote control api for game development automation, including asset management, actor control, level editing, animation, physics, visual effects, and cinematics creation through natural language. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Unreal Engine?

Install via npm with the command: npx -y unreal-engine-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Unreal Engine?

Unreal Engine works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Unreal Engine free to use?

Yes, Unreal Engine is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "unreal-engine-mcp-server": { "command": "npx", "args": ["-y", "unreal-engine-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Unreal Engine?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides