py-ue5-mcp-server logo

py-ue5-mcp-server

by edi3on

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

View on GitHub

Last updated: N/A

What is py-ue5-mcp-server?

This MCP server bridges the gap between Claude's natural language processing capabilities and Unreal Engine's powerful 3D environment, allowing users to control Unreal Engine through natural language.

How to use py-ue5-mcp-server?

Install the server, configure Claude Desktop to use it, enable the Remote Control API plugin in Unreal Engine, and then start chatting with Claude about creating or modifying content in Unreal Engine using example prompts.

Key features of py-ue5-mcp-server

  • Natural Language Control

  • Blueprint Actor Interaction

  • Scene Management

  • Asset Discovery

Use cases of py-ue5-mcp-server

  • Creating 3D objects with voice commands

  • Modifying existing scenes through text prompts

  • Automating level design tasks

  • Prototyping game mechanics with natural language

FAQ from py-ue5-mcp-server

What is the default unit of measurement?

The server uses centimeters as the default unit for all measurements (1 Unreal Unit = 1 cm).

What are the requirements to use this server?

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

How do I troubleshoot connection issues?

Ensure Unreal Engine is running before starting Claude Desktop, check that the Remote Control API plugin is enabled, verify no firewall is blocking communication on port 30010, and look for error messages in the Claude Desktop console.

How do I add new functions to the server?

Create a new helper function that implements the desired behavior, expose it to Claude using the @mcp.tool() decorator, and document the function clearly with docstrings.

What is the Remote Control API?

The Remote Control API is a built-in HTTP server that runs inside Unreal Engine, allowing external applications to interact with the engine.