Cube (Blender)

MCP protocol plugin for integrating Blender with AI

Image and video processing Developer tools #AI Integration #3D Control #Two-way Communication #Real-time Preview .Python

rating : 2.5 points

downloads : 7.0K

update time : 2025-04-28

Open Site

What is the Model Context Protocol (MCP) Server?

The MCP server is a tool for connecting AI assistants (such as Cursor AI) with Blender, allowing you to generate 3D models, modify materials, and manipulate scenes through AI.

How to use the MCP server?

Simply install and start the MCP server, then configure the connection in Cursor AI or other clients to start using it.

Applicable Scenarios

Suitable for users who need to quickly generate 3D models, adjust materials, or perform scene design, especially for creative design and AI-assisted workflows.

Main Features

Two-way Communication

Support real-time interaction between AI assistants and Blender through Socket connection.

Object Operation

Create, modify, or delete 3D objects, and support complex scene management.

Material Control

Apply and adjust material properties to achieve dynamic visual effects.

Scene Inspection

Get detailed information about the current Blender scene, including the number of objects and performance metrics.

Code Execution

Run custom Python scripts to extend functionality.

Real-time Preview

View effect changes through the continuously updated viewport image.

Advantages

Seamlessly integrate the workflows of AI assistants and Blender

Support multiple advanced functions, such as material editing and real-time preview

Open source and easy to extend

Limitations

Requires a certain foundation in Python to write custom scripts

Has certain requirements for hardware performance

How to Use

Download and Install

Download this repository and run the installation script (Windows: install.bat; macOS/Linux: ./install.sh).

Start the MCP Server

Open Blender, enable the MCP plugin, and click 'Start MCP Server' in the toolbar.

Configure Cursor AI

Add MCP commands in the Cursor settings to connect to Blender.

Usage Examples

Create and Apply Materials

Generate a sphere through an AI assistant and assign a metallic texture to it.

Real-time Preview of the Scene

Start the real-time preview mode to observe the changes in the scene over time.

Frequently Asked Questions

What if the port number is already occupied?

Why can't I see any effects?

Does it support other AI assistants?

Related Resources

Official GitHub Repository

Source code and documentation for the BlenderMCP plugin

cuBe Project Homepage

Detailed description and tutorials for the cuBe project

Official Tutorial Video

Video guide for quickly getting started with the MCP server

🚀 Blender MCP + Cursor AI MCP = cuBe

This package provides tools to install and configure the BlenderMCP plugin, enabling the integration of Blender with Cursor AI through the Model Context Protocol (MCP).

🚀 Quick Start

What is cuBe

cuBe is a Blender plugin that allows for the programmatic control of Blender via socket connections. This enables AI assistants like Cursor AI to create and manipulate 3D objects in Blender.

Official Repositories

The official repository for BlenderMCP is hosted on GitHub: https://github.com/ahujasid/blender-mcp

Please visit this repository for the latest updates, features, and community contributions.

The official repository for cuBe is hosted on GitHub: https://github.com/TheMapleseed/cuBe

✨ Features

Bidirectional Communication: Connect Claude AI or Cursor to Blender via a socket-based server.
Object Manipulation: Create, modify, and delete 3D objects in Blender.
Material Control: Apply and modify materials and colors.
Scene Inspection: Obtain detailed information about the current Blender scene.
Code Execution: Run arbitrary Python code in Blender.
Viewport Capture: Capture the current Blender viewport and receive it as an image.
Scene Metrics: Get detailed performance and scene statistics of Blender.
Real-time Preview: Stream real-time viewport updates.

📦 Installation

Prerequisites

Python 3.6 or higher
Blender 2.80 or higher

Installation Steps

Windows

Download or clone this repository.
Double-click install.bat.
Follow the prompts in the installer.

macOS/Linux

Download or clone this repository.
Open a terminal and navigate to the repository folder.
Make the installation script executable: chmod +x install.sh.
Run the installer: ./install.sh.
Follow the prompts in the installer.

💻 Usage Examples

Basic Usage

Launch Blender and enable the BlenderMCP plugin.
Find the BlenderMCP panel in Blender's settings.
Configure the required port and other parameters.
Start the server.
Connect to the BlenderMCP server from the client.

Advanced Usage

Viewport Capture: Start capturing by calling bmcapture.start(), stop capturing using bmcapture.stop(), and save the results to the specified path.
Real-time Preview: Start the real-time preview service, and other clients can view real-time updates by connecting to the specified port.

📚 Documentation

Troubleshooting

Port Occupied: If port 9876 is already in use, change the port in the BlenderMCP panel.
Plugin Not Found: Ensure that the plugin is correctly installed and enabled in Blender preferences.
Connection Failure: Check if the server is running and ensure that there is no firewall blocking the connection.
Viewport Capture Issue: Make sure there is a valid 3D viewport area in Blender.
Real-time Preview Not Working: Check if any other services are using the specified preview port.