blender-open-mcp

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:

• Render Support: Render images using the tool and retrieve information based on the output.

Installation

Prerequisites

1. Blender: Blender 3.0 or later. Download from blender.org.

2. Ollama: Install from ollama.com, following OS-specific instructions.

3. Python: Python 3.10 or later.

4. uv: Install using pip install uv.

5. Git: Required for cloning the repository.

Installation Steps

1. Clone the Repository:

2. Create and Activate a Virtual Environment (Recommended):

3. Install Dependencies:

4. Install the Blender Add-on:

5. Download an Ollama Model (if not already installed):(Other models like **`Gemma3`** can also be used.)

Setup

1. Start the Ollama Server: Ensure Ollama is running in the background.

2. Start the MCP Server:Or,By default, it listens on http://0.0.0.0:8000, but you can modify settings:

3. Start the Blender Add-on Server:

Usage

Example Commands

• Basic Prompt:

• Get Scene Information:

• Create a Cube:

• Render an Image:

• Using PolyHaven (if enabled):

Available Tools

Troubleshooting

• 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.

blender-open-mcp

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:

• Render Support: Render images using the tool and retrieve information based on the output.

Installation

Prerequisites

1. Blender: Blender 3.0 or later. Download from blender.org.

2. Ollama: Install from ollama.com, following OS-specific instructions.

3. Python: Python 3.10 or later.

4. uv: Install using pip install uv.

5. Git: Required for cloning the repository.

Installation Steps

1. Clone the Repository:

2. Create and Activate a Virtual Environment (Recommended):

3. Install Dependencies:

4. Install the Blender Add-on:

5. Download an Ollama Model (if not already installed):(Other models like **`Gemma3`** can also be used.)

Setup

1. Start the Ollama Server: Ensure Ollama is running in the background.

2. Start the MCP Server:Or,By default, it listens on http://0.0.0.0:8000, but you can modify settings:

3. Start the Blender Add-on Server:

Usage

Example Commands

• Basic Prompt:

• Get Scene Information:

• Create a Cube:

• Render an Image:

• Using PolyHaven (if enabled):

Available Tools

Troubleshooting

• 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.