unreal

This MCP server provides a Python-based bridge between Claude Desktop and Unreal Engine 5.3 via the Remote Control API. It exposes tools to create and manipulate Unreal Engine actors, spawn primitives and Blueprint-based actors, and discover assets within your Unreal project using natural language prompts. You can prompt Claude Desktop to place a red cube at a specific location, spawn a blueprint-based bench, or list available meshes in a folder, all through the MCP server which translates prompts to Unreal actions. The server handles connection setup to Unreal, translates high-level requests to Unreal Remote Control API calls, and returns results or status updates back to Claude Desktop.

To use it, configure the MCP server in Claude Desktop as shown in the quick start, start the server via the uv runner, ensure Unreal Engine is running with the Remote Control API plugin enabled, and then issue prompts from Claude Desktop. Typical interactions include creating primitive shapes with custom position/rotation/scale and color, spawning actors from Blueprints, moving or modifying existing objects, and listing assets. The server is designed to be an early integration layer that can be expanded with more capabilities as you refine your prompts and Unreal workflows.

Prerequisites:

• Python 3.10+ installed on your system
• Unreal Engine 5.3 with the Remote Control API plugin enabled
• Claude Desktop (Windows)

Step-by-step installation:

1. Clone the repository: git clone https://github.com/runeape-sats/unreal-mcp.git cd unreal-mcp

2. Install required Python packages: pip install uv mcp requests

3. Configure Claude Desktop to connect to the MCP server:

   • In Claude Desktop, go to File → Settings → Developer → Edit Config claude_desktop_config.json

   • Add the Unreal MCP server entry (adjust the path to your local repo):

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

4. Launch Unreal Engine with your project, ensuring the Remote Control API plugin is enabled.

5. Start Claude Desktop and ensure the unreal-mcp server is loaded by Claude Desktop on startup.

Optional development workflow (advanced):

• Install MCP CLI and run in development mode: pip install mcp[cli] mcp dev unreal_mcp_server.py

Environment considerations and tips:

• Ensure Unreal Engine is running before starting the MCP server to establish a connection with the Remote Control API.
• If you encounter connection issues, verify that port 30010 (Unreal's default Remote Control port) is not blocked by a firewall and that no other process is using it.
• The configuration example uses a placeholder path; replace it with the actual path to your unreal-mcp repository when configuring Claude Desktop.
• If you add more MCP servers in Claude Desktop, you may need to disable others to avoid conflicts.
• The server logs provide detailed information; check them for errors or tracebacks if prompts do not produce expected results.