blender-open-mcp
by dhakalnirajan
blender-open-mcp 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 AI to assist with 3D modeling tasks.
Last updated: N/A
What is blender-open-mcp?
blender-open-mcp is an open-source project that enables users to control Blender using natural language prompts by integrating it with local AI models through Ollama and the Model Context Protocol (MCP). It provides a Blender add-on and server to facilitate communication between the AI model and Blender.
How to use blender-open-mcp?
First, install Blender, Ollama, Python, uv, and Git. Clone the repository, create and activate a virtual environment, and install dependencies. Install the Blender add-on and start the Ollama server. Then, start the MCP server and the Blender add-on server. Finally, interact with blender-open-mcp using the mcp command-line tool with prompts or available tools.
Key features of blender-open-mcp
Control Blender with Natural Language
MCP Integration for structured communication
Ollama Support for local model management
Blender Add-on for user interface
PolyHaven Integration (Optional) for asset download
Basic 3D Operations (Create, Modify, Delete objects)
Render Support
Use cases of blender-open-mcp
Automating repetitive 3D modeling tasks with AI
Generating 3D models from natural language descriptions
Integrating AI-powered asset management into Blender
Creating interactive 3D environments with AI assistance
FAQ from blender-open-mcp
What are the prerequisites for using blender-open-mcp?
What are the prerequisites for using blender-open-mcp?
You need Blender 3.0 or later, Ollama, Python 3.10 or later, uv, and Git.
How do I install the Blender add-on?
How do I install the Blender add-on?
Open Blender, go to Edit -> Preferences -> Add-ons, click Install..., select the addon.py file, and enable the add-on.
How do I start the MCP server?
How do I start the MCP server?
Run the command blender-mcp or python src/blender_open_mcp/server.py in your terminal.
How do I send a prompt to Blender?
How do I send a prompt to Blender?
Use the mcp prompt "your prompt" --host http://localhost:8000 command.
What if I encounter issues?
What if I encounter issues?
Ensure Ollama and the blender-open-mcp server are running, check Blender’s add-on settings, verify command-line arguments, and refer to logs for error details. Visit the GitHub Issues page for further assistance.