tahooki/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:
bash
# 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
## 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:
1. MCP Server: Central hub communicating with AI agents via SSE (Server-Sent Events) on port 8000
2. Blender Addon: Socket server within Blender on port 8400 (standard) or 8401 (extended)
3. Unreal Plugin: HTTP server within Unreal Engine on port 8500
[AI Agent] [MCP Server (8300)]
|--HTTP--> [Blender Addon (8400)]
|--HTTP--> [Unreal Plugin (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 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
### 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
bash
# 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
### 2. Set Up Python Environment
bash
# 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 .
### 3. Install Blender Addon
Choose ONE of the following options:
#### Option A: Standard Addon (Original blender-mcp)
1. Open Blender
2. Navigate to Edit > Preferences > Add-ons