blender-mcp: AI-Assisted 3D Modeling with Claude via MCP Server
blender-mcp: AI-Assisted 3D Modeling with Claude
blender-mcp connects Blender to Claude AI via the Model Context Protocol, allowing developers to drive 3D modeling, scene creation, and object manipulation directly from AI prompts. This Python-based MCP Server acts as a bridge, translating Claude's instructions into Blender actions.
Wiring Claude to Blender
The core of blender-mcp is its socket-based, two-way communication between Claude AI and Blender. This integration is facilitated by two main components: a Blender Addon (addon.py) that creates a socket server within Blender to receive commands, and the MCP Server (src/blender_mcp/server.py) which implements the Model Context Protocol and connects to the Blender addon.
To get started, you'll need Blender 3.0+, Python 3.10+, and the uv package manager. Once the addon.py is installed in Blender's Add-ons preferences and enabled, the MCP Server can be configured for use with Claude. This involves including the Blender MCP server in your claude_desktop_config.json for Claude for Desktop integration, or configuring Cursor's MCP settings to run the server.
Direct AI Control Over Your 3D Scene
With blender-mcp, Claude gains a comprehensive set of capabilities for interacting with Blender:
- Object Manipulation: Create, modify, and delete 3D objects.
- Material Control: Apply and modify materials and colors.
- Scene Inspection: Retrieve detailed information about the current Blender scene.
- Code Execution: Run arbitrary Python code within Blender directly from Claude.
- Asset Integration: Access Poly Haven assets through their API and generate 3D models using Hyper3D Rodin.
These capabilities enable AI-driven workflows for tasks ranging from procedural scene generation to rapid prototyping of 3D assets based on natural language descriptions.
Installation and Setup
Prerequisites
Before installing, ensure you have:
- Blender 3.0 or newer
- Python 3.10 or newer
uvpackage manager:- Mac:
brew install uv - Windows:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"followed byset Path=C:\Users\nntra\.local\bin;%Path% - Otherwise, follow instructions on the uv website
- Mac:
Installing the Blender Addon
- Download the
addon.pyfile from the blender-mcp GitHub repository. - Open Blender.
- Navigate to
Edit > Preferences > Add-ons. - Click "Install..." and select the downloaded
addon.pyfile. - Enable the addon by checking the box next to "Interface: Blender MCP".
Once the addon is enabled in Blender, you can connect to Claude and begin interacting with Blender using the Blender MCP tools.