blender-open-mcp
@dhakalnirajan
About blender-open-mcp
Open Models MCP for Blender Using Ollama
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"blender-open-mcp": {
"command": "uv",
"args": [
"venv"
]
}
}
}Tools
16Full 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.
More Other MCP servers
Nginx UI
0xJackyYet another WebUI for Nginx
Awesome Mcp Servers
punkpeyeA collection of MCP servers.
EverArt
modelcontextprotocolModel Context Protocol Servers
Mcp
browsermcpBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
Comments