py-ue5-mcp-server

Unreal Engine 5 MCP Server for Claude

This repository contains a Model Context Protocol (MCP) Python server that enables Claude to interact with Unreal Engine 5 through natural language. By leveraging the Remote Control API, this integration allows you to create, manipulate, and control 3D objects and Blueprint actors in Unreal Engine directly through conversations with Claude.

Overview

This MCP server bridges the gap between Claude's natural language processing capabilities and Unreal Engine's powerful 3D environment. Users can simply describe what they want to create or modify in Unreal Engine, and Claude will interpret these requests and execute the appropriate actions through the MCP server.

Key Features

• Natural Language Control: Create and manipulate 3D objects using conversational text with Claude
• Blueprint Actor Interaction: Access functions in Blueprint actors through simple text prompts
• Scene Management: Build, modify, and arrange scenes with text-based instructions
• Asset Discovery: Search and utilize assets in your Unreal project through Claude
• Real-time Feedback: Get immediate visual results in your Unreal Engine viewport

Requirements

• Python 3.10+
• Unreal Engine 5.x with Remote Control API plugin enabled
• Claude Desktop (Windows)
• Basic knowledge of Unreal Engine fundamentals

Installation

1. Set Up the Repository

git clone https://github.com/yourusername/ue5-mcp.git
cd ue5-mcp
pip install uv mcp requests

2. Configure Claude Desktop

1. Open Claude Desktop
2. Go to File → Settings → Developer → Edit Config
3. Add the following to claude_desktop_config.json, adjusting the path to your local repository:

{
  "mcpServers": {
    "ue5-mcp": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\ue5-mcp", "run", "ue5_mcp_server.py"],
      "env": {}
    }
  }
}

Note: If you have other MCP servers configured, you may need to disable them to prevent conflicts.

3. Prepare Unreal Engine

1. Open Unreal Engine and your project
2. Ensure the Remote Control API plugin is enabled:
   • Edit → Plugins → Search for "Remote Control API"
   • Check that it's enabled and restart the editor if needed

Usage

Getting Started

1. Launch Unreal Engine with your project
2. Start Claude Desktop (restart it if it was already running)
3. Begin chatting with Claude about creating or modifying content in Unreal Engine

Example Prompts

Here are some example prompts you can use with Claude:

• "Create a snowman at position 0, 100, 50"
• "Spawn a snowman family in the scene"
• "Modify the center snowman's scale to make it bigger"
• "Move the snowman to position 100, 200, 0"
• "Rotate the snowman 45 degrees"
• "Get a list of all actors in the scene"

Understanding Units

The server uses centimeters as the default unit for all measurements:

• 1 Unreal Unit = 1 centimeter
• A standard snowman has dimensions of approximately 350cm × 350cm (3.5m × 3.5m)
• Positioning and scaling are all relative to this centimeter-based system

How It Works

Technical Implementation

The UE5-MCP server uses the following core components:

1. MCP Server Framework

The server is built using FastMCP, which establishes a bidirectional communication channel between Claude and Unreal Engine. The main components are:

# Create the MCP server with lifespan support
mcp = FastMCP(
    "Unreal-Engine-MCP",
    description="Unreal Engine integration through the Model Context Protocol (Default unit: CENTIMETERS)",
    lifespan=server_lifespan
)

2. Connection to Unreal Engine

The server connects to Unreal Engine through the Remote Control API, a built-in HTTP server that runs inside Unreal:

# Default Unreal Engine Remote Control API setting

... [View full README on GitHub](https://github.com/edi3on/py-ue5-mcp-server#readme)