Enables scene manipulation, object creation/editing, material management, PolyHaven asset integration, and Hyper3D Rodin model generation within Blender
Enables level creation/management, asset importing, Python code execution, and scene manipulation within Unreal Engine
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.
Overview
This project extends the blender-mcp framework to include support for Unreal Engine, allowing AI agents like Claude and ChatGPT to simultaneously control both platforms through a single interface.
Submodule Information
This project includes blender-mcp
as a Git submodule. When cloning the repository, use the following commands:
Features
Unified Control: Single MCP server to control both Blender and Unreal Engine
AI Agent Integration: Designed to work with Claude, ChatGPT, and other AI assistants
Blender Features: Retains all blender-mcp functionality including:
Scene manipulation
Object creation and editing
Material management
PolyHaven asset integration
Hyper3D Rodin model generation
Unreal Engine Features:
Level creation and management
Asset importing
Python code execution
Scene manipulation
Extension Structure: Easily extend both Blender addon and server while maintaining compatibility with upstream updates
Architecture
The system consists of three main components:
MCP Server: Central hub communicating with AI agents via SSE (Server-Sent Events) on port 8000
Blender Addon: Socket server within Blender on port 8400 (standard) or 8401 (extended)
Unreal Plugin: HTTP server within Unreal Engine on port 8500
Extension Structure
This project uses an extension approach to maintain compatibility with upstream changes:
Blender Addon Extension: Extends the original
BlenderMCPServer
while keeping the original code intactServer 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
Prerequisites
Python 3.10 or later
Blender 3.0 or later
Unreal Engine 5.0 or later
uv package manager (install with
pip install uv
if you don't have it)
1. Clone the Repository
2. Set Up Python Environment
3. Install Blender Addon
Choose ONE of the following options:
Option A: Standard Addon (Original blender-mcp)
Open Blender
Navigate to Edit > Preferences > Add-ons
Click "Install..." button
Browse and select
blender-mcp/addon.py
fileEnable the "Interface: Blender MCP" addon (check the box)
Option B: Extended Addon (With additional features)
Run the extension installer script:
python -c "from src.unreal_blender_mcp.blender_addon import BlenderAddonManager; BlenderAddonManager().install_to_blender(force=True)"Open Blender
Navigate to Edit > Preferences > Add-ons
Find and enable the "Interface: Extended Blender MCP" addon (check the box)
4. Install Unreal Engine Plugin
Locate the
UEPythonServer
folder in this projectCopy the entire folder to your Unreal project's
Plugins
directoryIf your project doesn't have a
Plugins
directory, create one
Start Unreal Engine with your project
Navigate to Edit > Plugins in the menu
Find and enable the Python Server plugin
Restart Unreal Engine when prompted
5. Start the MCP Server
Choose ONE of the following options:
Option A: Standard Server
Option B: Extended Server (More features)
6. Enable the Blender Server Connection
Start Blender (if not already running)
In the 3D viewport, press
N
to open the sidebar panelSelect the appropriate tab:
"BlenderMCP" (if using standard addon)
"ExtBlenderMCP" (if using extended addon)
Click the "Start Server" button
Verify the server starts successfully (check console output)
7. Verify Unreal Engine Connection
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
8. Connect an AI Agent
Option A: Integrate with Claude for Desktop
Add the following to Claude for Desktop's configuration:
Replace /path/to/
with your actual project path.
Option B: Integrate with Cursor
Open Cursor Settings
Navigate to MCP section
Add the following commands:
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.
Option C: Integrate with Other AI Tools
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)
9. Testing the System
Once all components are running:
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
Troubleshooting
If you encounter issues:
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 the Project Document and workflow directory.
Comparison: Standard vs Extended
Feature | Standard Server | Extended Server |
Blender Control | ✅ | ✅ |
Unreal Control | ✅ | ✅ |
Custom Blender Commands | ❌ | ✅ |
Enhanced Scene Info | ❌ | ✅ |
Auto Feature Detection | ❌ | ✅ |
Upstream Compatibility | ✅ | ✅ |
Choose the standard server for basic functionality or the extended server for advanced features.
Development
See the Project Document and workflow directory for detailed development information.
For extending this project:
To add new Blender addon features: Modify
src/unreal_blender_mcp/blender_addon/extended_addon.py
To add new server tools: Modify
src/unreal_blender_mcp/server_extension/extended_server.py
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgements
This project builds upon blender-mcp by Siddharth Ahuja.
Future Developments
The following improvements are planned for future releases:
Structured Unreal Engine API
Currently, the Unreal Engine communication relies primarily on direct Python code execution. A planned enhancement is to implement a structured API similar to the Blender integration:
Create predefined functions for common Unreal Engine operations
Implement proper error handling and validation
Improve security by limiting execution scope
Enhance stability and predictability of operations
Maintain backward compatibility while adding structure
This enhancement will create a more consistent experience across both engines and improve the overall reliability of the system. See the workflow documentation for more details on this planned development.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Unreal-Blender MCP is a unified server for controlling both Blender and Unreal Engine via AI agents using the MCP (Machine Control Protocol) approach.
- Overview
- Submodule Information
- Features
- Architecture
- Extension Structure
- Step-by-Step Installation and Setup Guide
- Comparison: Standard vs Extended
- Development
- License
- Acknowledgements
- Future Developments
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityConnects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender for AI-assisted 3D modeling, scene manipulation, and rendering.Last updated -1713,685MIT License
- AsecurityAlicenseAqualityMCP Unity Server to integrate Unity Editor game engine with different AI Model clients (e.g. Claude Desktop, Windsurf, Cursor)Last updated -51,016MIT License
- -securityAlicense-qualityA unified Model Context Protocol server that aggregates multiple MCP servers into one, allowing AI assistants like Claude Desktop, Cursor, and Cherry Studio to connect to a single server instead of managing multiple instances.Last updated -148198Apache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for Adobe After Effects that enables AI assistants and other applications to control After Effects through a standardized protocol.Last updated -13117MIT License