py-ue5

The py-ue5 MCP server provides a Python-based bridge between Claude and Unreal Engine 5 via the Remote Control API. It exposes a set of tooling functions that allow Claude to query the current scene, spawn and manipulate Blueprint actors, and perform scene management tasks—all through natural-language prompts. Typical workflows involve Claude interpreting a user request (for example, “spawn a snowman at position 0, 100, 50” or “move the center snowman to 100, 200, 0”) and calling the corresponding MCP tooling functions to execute the action inside Unreal Engine. The server communicates with Unreal Engine’s Remote Control API over HTTP, using a default endpoint on localhost: 30010, to send commands and receive results in JSON.

Available tools include: get_all_scene_actors for listing actors in the current level, spawn_actor to instantiate blueprint actors at a given location and rotation, spawn_snowman_family to create a coordinated trio of snowmen, and modify_actor to update properties like position, rotation, and scale of existing actors. There are also examples showing how to construct payloads that call Blueprint functions or UE5’s built-in utilities via the Remote Control API. This enables Claude to perform complex scene construction and adjustments with concise natural-language prompts.

To use it, start Unreal Engine with your project and ensure the Remote Control API plugin is enabled, then run Claude Desktop with the configured MCP server entry. Engage in a conversation with Claude, using prompts aligned to the tool capabilities (e.g., spawn, move, rotate, scale, list actors, or duplicate actors) and Claude will translate them into MCP tool calls and UE5 Remote Control API requests.

Prerequisites:

• Python 3.10+
• Unreal Engine 5.x with Remote Control API plugin enabled
• Claude Desktop (Windows)
• Internet access to install Python packages if needed

1. Clone the repository and install dependencies

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

2. Configure Claude Desktop to run the MCP server

• Open Claude Desktop
• Navigate to File → Settings → Developer → Edit Config
• Add an MCP server entry pointing to the Python script, for example:

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

• Adjust the path to your local repository as needed.

3. Prepare Unreal Engine project

• Open Unreal Engine and your project
• Enable the Remote Control API plugin (Edit → Plugins → Remote Control API) and restart the editor if prompted

4. Run the MCP server

• Ensure Unreal Engine is running, then start Claude Desktop and select the configured MCP server (ue5-mcp) from Claude’s settings or prompts.
• Begin issuing natural-language commands to control the UE5 scene.

Environment and configuration tips:

• Default UE Remote Control API URL is http://127.0.0.1:30010/remote/object/call. If you change the port, update the server configuration accordingly.
• The server uses centimeters as the default unit; all position and scale values are interpreted accordingly.
• Keep Claude Desktop and Unreal Engine on the same machine or ensure network connectivity between them if running across devices.
• If you have multiple MCP servers configured, disable others to prevent port/command conflicts.
• For troubleshooting, verify that the Remote Control API is reachable from the machine running Claude Desktop (you can curl the endpoint to test).