Unreal-Blender MCP

Unreal-Blender MCP is a unified server for controlling both Blender and Unreal Engine via AI agents using the MCP (Machine Control Protocol) approach.

This project extends theblender-mcpframework to include support for Unreal Engine, allowing AI agents like Claude and ChatGPT to simultaneously control both platforms through a single interface.

# Clone with submodules git clone --recursive https://github.com/tahooki/unreal-blender-mcp.git # Or clone normally and then initialize submodules git clone https://github.com/tahooki/unreal-blender-mcp.git cd unreal-blender-mcp git submodule update --init --recursive

[AI Agent] <--SSE--> [MCP Server (8300)] | |--HTTP--> [Blender Addon (8400)] | |--HTTP--> [Unreal Plugin (8500)]

This project uses an extension approach to maintain compatibility with upstream changes:

- Blender Addon Extension: Extends the originalBlenderMCPServerwhile keeping the original code intact
- Server Extension: Enhances the original server with additional tools and Unreal Engine integration
- Interface Tools: Provides utilities for installing, configuring, and running extensions

This approach allows easy updates from the original projects without code conflicts.

Step-by-Step Installation and Setup Guide

- Python 3.10 or later
- Blender 3.0 or later
- Unreal Engine 5.0 or later
- uv package manager (install withpip install uvif you don't have it)

# Clone with submodules (recommended) git clone --recursive https://github.com/tahooki/unreal-blender-mcp.git cd unreal-blender-mcp # Or if you already cloned without --recursive: git clone https://github.com/tahooki/unreal-blender-mcp.git cd unreal-blender-mcp git submodule update --init --recursive

# Create a virtual environment and activate it uv venv # On Windows: .\venv\Scripts\activate # On macOS/Linux: source venv/bin/activate # Install project dependencies uv pip install -e .

Option A: Standard Addon (Original blender-mcp)

Option B: Extended Addon (With additional features)

python -c "from src.unreal_blender_mcp.blender_addon import BlenderAddonManager; BlenderAddonManager().install_to_blender(force=True)"

- Locate theUEPythonServerfolder in this project
- Copy the entire folder to your Unreal project'sPluginsdirectory

- If your project doesn't have aPluginsdirectory, create one

# Make sure your virtual environment is activated python main.py

Option B: Extended Server (More features)

# Make sure your virtual environment is activated python run_extended_server.py # Optional: Customize server options python run_extended_server.py --host 127.0.0.1 --port 8080 --log-level DEBUG

- Start Blender (if not already running)
- In the 3D viewport, pressNto open the sidebar panel
- Select the appropriate tab:

- "BlenderMCP" (if using standard addon)
- "ExtBlenderMCP" (if using extended addon)
- With Unreal Engine running and plugin enabled
- The Python server should automatically start
- Check the Output Log (Window > Developer Tools > Output Log) for any messages
- The Unreal plugin should now be ready to receive commands

Option A: Integrate with Claude for Desktop

Add the following to Claude for Desktop's configuration:

{ "mcpServers": { "unreal-blender": { "command": "uvx", "args": [ "unreal-blender-mcp" ] }, "unreal-blender-ext": { "command": "python", "args": [ "/path/to/unreal-blender-mcp/run_extended_server.py" ] } } }

Replace/path/to/with your actual project path.

- Standard Server:uvx unreal-blender-mcp
- Extended Server:python /path/to/unreal-blender-mcp/run_extended_server.py

Replace/path/to/with your actual project path.

Refer to your AI tool's documentation for integrating with MCP servers, and point it to:

- MCP Server URL:http://localhost:8000(or custom port if specified)
-

Use your AI agent to interact with Blender by asking it to:

- Create a simple cube or sphere
- Modify object properties
- Create materials

Use your AI agent to interact with Unreal Engine by asking it to:

- Create a new level
- Place assets
- Modify scene properties

Try more complex operations that involve both platforms working together
- Check that all servers are running (MCP, Blender, Unreal)
- Verify port configurations match (default: 8000 for MCP, 8400/8401 for Blender, 8500 for Unreal)
- Check console outputs for error messages
- Restart components in the correct order: MCP server first, then Blender, then Unreal Engine

For more detailed information on development and extending the system, see theProject Documentandworkflowdirectory.

See theProject Documentandworkflowdirectory for detailed development information.

- This project builds uponblender-mcpby Siddharth Ahuja.

This enhancement will create a more consistent experience across both engines and improve the overall reliability of the system. See theworkflow documentationfor more details on this planned development.

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent