Unrealmcpbridge

This is an Unreal Engine plugin that implements the Model Context Protocol (MCP) server, allowing MCP clients (such as Claude) to access all functions of Unreal Engine through the Python API.

Developer tools Games and gamification #UE Plugin #MCP Protocol #Python Bridge #AI Collaboration .cpp

rating : 2.5 points

downloads : 7.6K

update time : 2025-04-28

Open Site

What is the MCP Python Bridge?

This plugin implements the Model Context Protocol (MCP) server in Unreal Engine, allowing AI agents to access and control UE through Python scripts. It bridges between Claude (or other MCP-compatible AI) and Unreal Engine's Python API.

How does it work?

The plugin creates a local server that listens for commands from the AI agent. When you run a prompt in Claude, it sends Python commands through MCP which are executed in Unreal Engine.

Use Cases

Ideal for automating repetitive tasks, generating content procedurally, or getting AI assistance with Unreal Engine development workflows.

Key Features

Full UE Python API Access

Provides complete access to Unreal Engine's Python API through MCP protocol

Prebuilt Prompts

Includes ready-to-use prompts like 'create_castle' that demonstrate common automation tasks

Custom Tool Development

Easily create new tools and prompts that appear in Claude's interface

Advantages

Enables AI-assisted Unreal Engine development

Reduces repetitive manual work through automation

Extensible through custom Python tools and prompts

Works with any MCP-compatible AI agent

Limitations

Requires basic Python knowledge for advanced customization

Need to restart Claude after modifying tools

Windows users may need to manually kill Claude process

Getting Started

Install the Plugin

Install from Fab store or clone from GitHub into your project's Plugins folder

Configure Claude

Add the MCP server configuration to claude_desktop_config.json with path to unreal_mcp_client.py

Enable and Start

Enable the plugin in UE Editor and click 'Start MCP Bridge' button

Connect Claude

In Claude desktop app, click 'Attach from MCP' plug icon and select integration

Example Use Cases

Scene Generation

Automatically generate complete scenes using basic shapes

Asset Processing

Batch process assets in Content Browser

Frequently Asked Questions

Do I need to know Python to use this?

Why isn't Claude recognizing my new tools?

Can I use other AI agents besides Claude?

Additional Resources

Model Context Protocol Documentation

Official MCP protocol specifications

Unreal Engine Python API

Reference for available Python commands

Plugin GitHub Repository

Source code and issue tracking

🚀 Unreal Engine MCP Python Bridge Plugin

This is a plugin for Unreal Engine (UE) that implements the server-side of the Model Context Protocol (MCP). This plugin allows MCP clients like Anthropic's Claude to access the full UE Python API.

🚀 Quick Start

✨ Features

Develop tools and workflows in Python and automate them via agents like Claude.
Implement intelligent and dynamic automation of workflows.
Collaborate with agents for general collaborative development.

📦 Installation

Install from Fab

The easiest way to install the MCP Python Bridge Plugin is from the Fab store page. After purchase, the plugin will appear in your Epic Games Launcher library. Click "Install to Unreal Engine" and follow the prompts to complete the installation.

Install from GitHub

If you can't install via Fab, you can download the source code from GitHub and build it manually:

Visit the GitHub repository.
Clone the repository to your local development environment.
Open Visual Studio 2019 or later and open the .uproject file in the project folder.
Click "Build" to generate the plugin.

💻 Usage Examples

Prerequisites

Visual Studio 2019 or later (if building from source).
An AI agent. The following assumes you're using Claude, but any AI agent implementing MCP can be used.
Unreal Engine 5 with the Python Editor Scripting Plugin enabled.
Familiarize yourself with the Unreal Engine Python API.

Basic Usage

To add new tools and prompts in unreal_mcp_client.py, simply follow the existing pattern. For example, here's how to define a new prompt named create_castle() in the client:

@mcp.prompt()
def create_castle() -> str:
    """Create a castle"""
    return f"""
Please create a castle in the current Unreal Engine project.
0. Refer to the Unreal Engine Python API for documentation on creating new code: https://dev.epicgames.com/documentation/en-us/unreal-engine/python-api/?application_version=5.5
1. Clean up all StaticMeshActors in the scene.
2. Get the project directory and content directory.
3. Find the basic shapes for building structures.
4. Use these basic shapes to create a castle.
"""

After each modification to unreal_mcp_client.py, you must restart Claude for the changes to take effect. On Windows, you may need to end the Claude process via the Task Manager to fully restart it.

By following the steps above, you can easily integrate new tools and prompts into the MCP Python Bridge Plugin and expand your interaction capabilities with Claude.