Happy slice of mcp pizzaMCP.pizza

blender-open-mcp

MCP.Pizza Chef: dhakalnirajan

Sixteen tools let you add shapes, move and scale them, apply materials and textures, pull free assets from PolyHaven, and render the result, all driven from chat with a local Ollama model doing the thinking so nothing leaves your machine. Two tools deserve caution: one deletes an object outright with no confirmation, and another runs any Python code inside Blender, which the project's own example uses to execute code an AI has just written. Save your work before you start.

Coding
Images/Design
Other

Use This MCP server To

Add a metallic sphere to my scene without touching the menus Apply a downloaded brick texture to an object Render the current scene straight to an image file Ask what objects and cameras are in my scene Move and resize an object by describing where I want it

README

blender-open-mcp

Open Models MCP for Blender3D using Ollama

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

Architecture

MCP Client (Claude/Cursor/CLI)
         │ HTTP / stdio
         ▼
┌─────────────────────┐
│   FastMCP Server    │  ← server.py  (port 8000)
│   blender-open-mcp  │
└─────────────────────┘
    │ TCP socket           │ HTTP
    ▼                      ▼
┌──────────────┐    ┌─────────────┐
│  Blender     │    │   Ollama    │  (port 11434)
│  Add-on      │    │  llama3.2   │
│  addon.py    │    │  gemma3...  │
│  (port 9876) │    └─────────────┘
└──────────────┘
       │ bpy
       ▼
  Blender Python API

Three independent processes:

  • FastMCP Server (server.py): Exposes MCP tools over HTTP or stdio
  • Blender Add-on (addon.py): TCP socket server running inside Blender
  • Ollama: Local LLM serving natural language queries

Installation

Prerequisites

Dependency Version Install
Blender 3.0+ blender.org
Python 3.10+ System or python.org
Ollama Latest ollama.com
uv Latest pip install uv

1. Clone and set up

blender-open-mcp FAQ

Do I need a key or an account?
No. It runs entirely on your own computer through Ollama, so there is nothing to sign up for. You do need Blender 3.0 or newer, Python, Ollama, and a model downloaded.
Can it break my scene?
Yes. One tool deletes an object with no confirmation, and another runs any Python code inside Blender. Both are correctly marked as destructive in the code, but whether your assistant asks you first is up to that app.
Can I use this to build a scene by describing it?
Yes — ask for shapes, positions, materials, textures and a render, and it carries each step out in your open Blender window.
Which apps does it work in?
Claude Desktop and Cursor are documented, and it works with anything that can start a local command.
How hard is setup?
Developer-level, and there are three moving parts. You install the project, install an add-on inside Blender and start its server, then run Ollama with a model pulled.
Does the command-line client in the README work?
No. The blender-mcp-client command points at a folder that is not in the project, so that section of the README and the code example beside it cannot run as written.
Is my work kept private?
By default yes, because the model runs on your own machine. If you run the server in its web mode, though, it listens on every network interface with no login, so keep that off shared networks.
Can I use this at work?
Ask whoever handles licences first. Despite the README saying MIT, the project ships a custom licence with extra clauses that GitHub does not recognise as a standard open-source one.