py-ue5-mcp-server

What is py-ue5-mcp-server?

py-ue5-mcp-server is a Model Context Protocol (MCP) Python server that enables Claude to interact with Unreal Engine 5 through natural language. It uses Unreal Engine's Remote Control API to let users create, manipulate, and control 3D objects and Blueprint actors directly from conversations with Claude. The server is built for Claude Desktop users who want to drive Unreal Engine 5 scenes using plain English prompts.

How to use py-ue5-mcp-server?

1. Install the repository, pip install uv mcp requests, and configure Claude Desktop’s claude_desktop_config.json to point to the server script.
2. Enable the Remote Control API plugin in Unreal Engine 5 (Edit → Plugins → Remote Control API).
3. Launch Unreal Engine with your project, start Claude Desktop, and begin chatting with Claude to spawn, modify, or list actors.

Key features of py-ue5-mcp-server

• Natural language control of Unreal Engine objects via Claude
• Blueprint actor interaction through text prompts
• Scene building, modification, and arrangement
• Asset discovery and searching within Unreal projects
• Real-time visual feedback in the Unreal viewport

Use cases of py-ue5-mcp-server

• Spawn a snowman or snowman family at a given position
• Modify an actor’s scale, rotation, or location
• Get a list of all actors currently in the scene
• Duplicate existing Blueprint actors with adjusted properties
• Arrange complex scenes using simple conversational commands

FAQ from py-ue5-mcp-server

What are the runtime requirements for py-ue5-mcp-server?

Python 3.10+, Unreal Engine 5.x with the Remote Control API plugin enabled, and Claude Desktop (Windows). Basic knowledge of Unreal Engine is recommended.

How does py-ue5-mcp-server connect to Unreal Engine?

It uses the Remote Control API, Unreal’s built-in HTTP server, running by default on http://127.0.0.1:30010. The server sends HTTP requests to call functions such as SpawnActorFromClass.

What unit system does py-ue5-mcp-server use?

The server uses centimeters as the default unit. 1 Unreal Unit equals 1 centimeter. For example, a standard snowman is approximately 350 cm × 350 cm.

Can I use py-ue5-mcp-server alongside other MCP servers?

The README notes that if you have other MCP servers configured, you may need to disable them to prevent conflicts.

What should I do if Claude cannot connect to Unreal Engine?

Ensure Unreal Engine is running before starting Claude Desktop, verify the Remote Control API plugin is enabled, check that port 30010 is not blocked by a firewall, and look for error messages in the Claude Desktop console or server logs.