blender-open-mcp

Name: blender-open-mcp
Author: dhakalnirajan

@dhakalnirajan

Repository

About blender-open-mcp

Open Models MCP for Blender Using Ollama

#python #blender3d #blender #mcp #blender-addon #model-context-protocol #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "blender-open-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

Full scene summary: objects, camera, render settings

Detailed object info: transforms, materials, mesh stats

Add a primitive mesh (CUBE, SPHERE, CYLINDER, ...)

Change location, rotation, scale, visibility

Remove an object from the scene

Create and assign a Principled BSDF material

Render current scene to a file

Run arbitrary Python/bpy code in Blender

List PolyHaven asset categories

Search PolyHaven library with pagination

Download & import a PolyHaven asset

Apply a downloaded PolyHaven texture to an object

Send a natural language prompt to Ollama

List available local Ollama models

Switch the active Ollama model

Update the Ollama server URL

Overview

What is blender-open-mcp?

Control Blender 3D with natural language prompts via local AI models. It connects MCP clients (Claude, Cursor, or any MCP client) to Blender through a local Ollama LLM. Built on the Model Context Protocol.

How to use blender-open-mcp?

Install prerequisites (Blender 3.0+, Python 3.10+, Ollama, uv). Clone the repo, create a venv with uv, install the package, install the Blender add-on (addon.py), pull an Ollama model (e.g. llama3.2), start Ollama, then run blender-mcp (with optional host/port/model flags). For stdio transport (Claude Desktop, Cursor) use --transport stdio. Use the bundled CLI (blender-mcp-client) or the Python API to interact.

Key features of blender-open-mcp

Natural language control of Blender via local AI (Ollama)
Supports multiple MCP transports (HTTP and stdio)
Full Blender scene inspection and object manipulation
Material assignment, rendering, and PolyHaven asset integration
Execute arbitrary Python/bpy code in Blender
Switch active Ollama model and server URL at runtime

Use cases of blender-open-mcp

Create and modify Blender scenes using plain English prompts
Automate repetitive tasks (adding objects, applying materials, rendering)
Integrate AI-assisted code generation into Blender pipelines
Browse and import PolyHaven textures and materials
Control Blender remotely from any MCP-compatible client

FAQ from blender-open-mcp

What are the prerequisites for blender-open-mcp?

Blender 3.0+, Python 3.10+, the latest Ollama, and uv. An internet connection is needed to pull Ollama models and PolyHaven assets.

How do I connect Claude Desktop or Cursor to blender-open-mcp?

Add the server configuration to your mcp.json (or ~/.cursor/mcp.json) with the command "blender-mcp" and args ["--transport", "stdio"].

Why can't the server connect to the Blender add-on?

Open Blender, go to the 3D Viewport N‑sidebar, find the Blender MCP panel, and click "Start MCP Server". The add‑on listens on port 9876 by default.

What ports does blender-open-mcp use?

FastMCP server: port 8000 (configurable). Blender add‑on TCP socket: port 9876. Ollama: port 11434.

Can I use a different Ollama model?

Yes. Pull any model with ollama pull <model> and specify it at server start with --ollama-model <model>, or switch it later via the blender_set_ollama_model tool.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K