Skip to main content
Glama

Unreal Engine MCP Bridge

by gingerol
MIT License

Unreal Engine MCP (Model Context Protocol) Bridge

This project provides a bridge between text-based AI models and Unreal Engine 5.5+ using the Model Context Protocol (MCP). It allows you to control Unreal Engine using natural language commands and Python scripts.

Overview

The Unreal MCP Bridge enables:

  • Creating and manipulating Blueprints
  • Spawning and modifying actors in the level
  • Working with Blueprint nodes and connections
  • Managing project settings and input mappings
  • Creating and modifying UMG widgets
  • And much more!

Requirements

  • Unreal Engine 5.5 or later with Python support enabled
  • Python 3.10 or later
  • uv package manager (recommended) or pip

Installation

  1. Clone this repository to your local machine
  2. Install dependencies using uv:
uv pip install -e .

Or using pip:

pip install -e .
  1. Make sure Unreal Engine is running with Python support enabled

Usage

Starting the MCP Server

To start the MCP server, run:

python unreal_mcp_server.py

This will start the server and register all available tools for interacting with Unreal Engine.

Using Example Scripts

The examples directory contains several example scripts that demonstrate how to use the MCP to interact with Unreal Engine:

  • add_cube.py: Spawns a cube actor in the level with customizable properties
  • create_rotating_cube_blueprint.py: Creates a Blueprint with a cube that rotates continuously
  • create_simple_game.py: Creates a simple game with a player character, collectibles, and score display

To run an example script:

python examples/add_cube.py

Available Tool Categories

The MCP Bridge provides tools in several categories:

Editor Tools

Tools for working with the Unreal Editor and actors in the level:

  • Getting and finding actors
  • Spawning and deleting actors
  • Setting actor transforms and properties
  • Taking screenshots
  • Selecting actors
Blueprint Tools

Tools for creating and modifying Blueprint assets:

  • Creating new Blueprints
  • Adding and removing components
  • Setting component properties
  • Compiling Blueprints
Node Tools

Tools for working with Blueprint graph nodes and connections:

  • Adding various node types (events, functions, variables)
  • Connecting nodes
  • Finding and deleting nodes
Project Tools

Tools for project-level operations:

  • Creating input mappings
  • Setting project settings
  • Creating and managing levels
  • Setting up GameModes
UMG Tools

Tools for creating and modifying UMG widgets:

  • Creating Widget Blueprints
  • Adding various widget types (Text, Button, Image, etc.)
  • Binding widget events
  • Managing widget properties

Extending the MCP

You can extend the MCP by adding new tools to the appropriate tool modules in the tools directory. Each tool should be registered with the MCP server in unreal_mcp_server.py.

Troubleshooting

  • Make sure Unreal Engine is running before starting the MCP server
  • Check that Python support is enabled in your Unreal Engine project
  • Verify that the MCP server is running and listening for commands
  • Look for error messages in the console output

License

This project is licensed under the MIT License - see the LICENSE file for details.

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

A server that enables control of Unreal Engine 5.5+ using natural language commands, allowing users to create Blueprints, manipulate actors, work with nodes, manage project settings, and create UMG widgets through the Model Context Protocol.

  1. Overview
    1. Requirements
      1. Installation
        1. Usage
          1. Starting the MCP Server
          2. Using Example Scripts
          3. Available Tool Categories
        2. Extending the MCP
          1. Troubleshooting
            1. License

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables AI clients to interact with virtual Ubuntu desktops, allowing them to browse the web, run code, and control instances through mouse/keyboard actions and bash commands.
                Last updated -
                5
                9
                JavaScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                Unreal-Blender MCP is a unified server for controlling both Blender and Unreal Engine via AI agents using the MCP (Machine Control Protocol) approach.
                Last updated -
                Python
                • Linux
                • Apple
              • -
                security
                F
                license
                -
                quality
                A server implementation that enables remote Python code execution in Unreal Engine environments, featuring automatic Unreal node discovery and management through a multicast network.
                Last updated -
                2
                Python
              • -
                security
                F
                license
                -
                quality
                A server that enables AI assistants to interact with Linear's project management tools through the Model Context Protocol, supporting features like searching, creating, and updating issues, adding comments, and retrieving user profiles and team information.
                Last updated -
                TypeScript
                • Apple
                • Linux

              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/gingerol/UnrealEngine-ai-mcp'

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