Enables control of Blender using natural language prompts, allowing for 3D modeling tasks such as creating and modifying objects, applying materials, and rendering images through a Blender add-on that handles communication with the server.
Uses locally running Ollama models to process natural language commands, with the ability to switch between different models like llama3.2 or Gemma3, and query available models from the Ollama server.
blender-open-mcp
blender-open-mcp
is an open source project that integrates Blender with local AI models (via Ollama) using the Model Context Protocol (MCP). This allows you to control Blender using natural language prompts, leveraging the power of AI to assist with 3D modeling tasks.
Features
Control Blender with Natural Language: Send prompts to a locally running Ollama model to perform actions in Blender.
MCP Integration: Uses the Model Context Protocol for structured communication between the AI model and Blender.
Ollama Support: Designed to work with Ollama for easy local model management.
Blender Add-on: Includes a Blender add-on to provide a user interface and handle communication with the server.
PolyHaven Integration (Optional): Download and use assets (HDRIs, textures, models) from PolyHaven directly within Blender via AI prompts.
Basic 3D Operations:
Get Scene and Object Info
Create Primitives
Modify and delete objects
Apply materials
Render Support: Render images using the tool and retrieve information based on the output.
Installation
Prerequisites
Blender: Blender 3.0 or later. Download from blender.org.
Ollama: Install from ollama.com, following OS-specific instructions.
Python: Python 3.10 or later.
uv: Install using
pip install uv
.Git: Required for cloning the repository.
Installation Steps
Clone the Repository:
git clone https://github.com/dhakalnirajan/blender-open-mcp.git cd blender-open-mcpCreate and Activate a Virtual Environment (Recommended):
uv venv source .venv/bin/activate # On Linux/macOS .venv\Scripts\activate # On WindowsInstall Dependencies:
uv pip install -e .Install the Blender Add-on:
Open Blender.
Go to
Edit -> Preferences -> Add-ons
.Click
Install...
.Select the
addon.py
file from theblender-open-mcp
directory.Enable the "Blender MCP" add-on.
Download an Ollama Model (if not already installed):
ollama run llama3.2(Other models like
Setup
Start the Ollama Server: Ensure Ollama is running in the background.
Start the MCP Server:
blender-mcpOr,
python src/blender_open_mcp/server.pyBy default, it listens on
http://0.0.0.0:8000
, but you can modify settings:blender-mcp --host 127.0.0.1 --port 8001 --ollama-url http://localhost:11434 --ollama-model llama3.2Start the Blender Add-on Server:
Open Blender and the 3D Viewport.
Press
N
to open the sidebar.Find the "Blender MCP" panel.
Click "Start MCP Server".
Usage
Interact with blender-open-mcp
using the mcp
command-line tool:
Example Commands
Basic Prompt:
mcp prompt "Hello BlenderMCP!" --host http://localhost:8000Get Scene Information:
mcp tool get_scene_info --host http://localhost:8000Create a Cube:
mcp prompt "Create a cube named 'my_cube'." --host http://localhost:8000Render an Image:
mcp prompt "Render the image." --host http://localhost:8000Using PolyHaven (if enabled):
mcp prompt "Download a texture from PolyHaven." --host http://localhost:8000
Available Tools
Tool Name | Description | Parameters |
| Retrieves scene details. | None |
| Retrieves information about an object. |
(str) |
| Creates a 3D object. |
,
,
,
,
|
| Modifies an object’s properties. |
,
,
,
,
|
| Deletes an object. |
(str) |
| Assigns a material to an object. |
,
,
|
| Renders an image. |
(str) |
| Executes Python code in Blender. |
(str) |
| Lists PolyHaven asset categories. |
(str) |
| Searches PolyHaven assets. |
,
|
| Downloads a PolyHaven asset. |
,
,
,
|
| Applies a downloaded texture. |
,
|
| Sets the Ollama model. |
(str) |
| Sets the Ollama server URL. |
(str) |
| Lists available Ollama models. | None |
Troubleshooting
If you encounter issues:
Ensure Ollama and the
blender-open-mcp
server are running.Check Blender’s add-on settings.
Verify command-line arguments.
Refer to logs for error details.
For further assistance, visit the GitHub Issues page.
Happy Blending with AI! 🚀
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A server that integrates Blender with local AI models via the Model Context Protocol, allowing users to control Blender using natural language prompts for 3D modeling tasks.
Related MCP Servers
- -securityFlicense-qualityA server that provides rich UI context and interaction capabilities to AI models, enabling deep understanding of user interfaces through visual analysis and precise interaction via Model Context Protocol.Last updated -60
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI agents to generate, fetch, and manage UI components through natural language interactions.Last updated -3206
Plane MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that enables AI interfaces to seamlessly interact with Plane's project management system, allowing management of projects, issues, states, and other work items through a standardized API.Last updated -4689086MIT License- -securityAlicense-qualityA server that implements the Model Context Protocol, providing a standardized way to connect AI models to different data sources and tools.Last updated -010MIT License