Blender-AI-MCP-Suite README

The project's README from github.com/findavoulot1973/Blender-AI-MCP-Suite. As one markdown file: README.md.

Blender AI MCP Suite

Blender AI MCP Suite is an AI assistant and built-in Model Context Protocol (MCP) server for Blender that turns plain-language briefs into inspected, approved and reversible 3D scene operations — with a visual Studio workspace, multi-agent teams, 21+ scene tools and your choice of AI models.

License Python Windows MCP Blender AI Release

Download

Picture the workflow: you type "Build a night product stage with a pedestal, a camera and three lights" — the assistant inspects the scene, plans ordered steps, places the pedestal, aims the camera, sets the lights, applies a matte blue material and returns a viewport screenshot for review. Every step is approved in chat, every change is reversible through a named undo checkpoint, and the scene is export-ready when you are.

Why

3D work is full of mechanical steps — arranging props, tuning materials, re-exporting variations — while generic chat tabs cannot see your scene and blind scripts edit without review. Blender AI MCP Suite puts the assistant inside Blender: it inspects the scene first, then builds, edits and exports through a validated tool set you approve step by step, with undo checkpoints on every mutation. You iterate at the speed of conversation and keep full creative control.

Without / With

Without With
Hours of manual clicks for layouts, materials and exports One plain-language brief becomes a finished, checked scene
Chat tabs that cannot see your 3D scene An assistant that inspects objects, transforms and materials before acting
Blind scripts and hard-to-trace changes Every operation shown in chat, approved and reversible
One model stretched across every kind of task A team of manager, workers and reviewers, each fit for its role
Asset hunting across many websites Poly Haven, Sketchfab and Poly Pizza searched from one chat
Lock-in to a single AI vendor Cloud providers, local Ollama models or custom endpoints

Quick Start

  1. Download mcp-for-blender-pro.zip from Releases.
  2. In Blender, open Edit → Preferences → Get Extensions → menu → Install from Disk.
  3. Select the ZIP, enable mcp-for-blender-pro, then open 3D Viewport → N → MCP Pro.
  4. Choose a provider, add your connection details and select a model.
  5. Send a message in Blender or click Open Studio Window.

Features

How it works

Blender AI MCP Suite runs inside Blender as one extension with three cooperating parts: the AI Suite sidebar (chat, scene outline, viewport snapshots, approvals and the task board), the connection manager (saved providers, keys and models, kept separate for work and personal use) and the built-in MCP server (an authenticated local Streamable HTTP endpoint for external clients). A brief is inspected through 21+ scene tools, split into ordered steps that run one by one — each visible, approved and reversible — while larger jobs are delegated to a manager, workers and reviewers; external clients such as OpenCode drive the same tool set through the MCP endpoint.

Usage

Configuration

Setting What it controls Default
Provider AI connection: OpenAI, Anthropic Claude, Google Gemini, OpenRouter, OpenCode Zen, Ollama or a custom API Set on first run
Model Tool-calling model for chat, vision and agents Chosen from the provider catalog
Saved connections Separate work and personal keys, multiple keys per provider Personal
Team chain Roles, instructions and models for manager, workers and reviewers Single assistant
MCP endpoint Authenticated local Streamable HTTP server for external clients Active with Studio
Interface language English, German, French, Spanish or Chinese English
Asset services Keys for Poly Haven, Sketchfab and Poly Pizza Empty
Undo checkpoints Named undo steps before mutating operations Enabled

Troubleshooting / FAQ

The add-on does not appear after installation. Confirm you are running Blender 4.2 or later on Windows x64, reinstall via Edit → Preferences → Get Extensions → menu → Install from Disk and enable Blender AI MCP Suite.

Windows blocked the downloaded ZIP. Right-click the archive, open Properties, check Unblock and confirm, then install it again.

The assistant does not answer or changes nothing. Check the saved connection details and key, select a model with tool-calling support, and approve the pending operation in the chat.

An external MCP client cannot connect. Keep Blender open while using Studio or external clients, confirm the client supports authenticated Streamable HTTP MCP, and copy the endpoint exactly as shown in the sidebar.

A team task stopped. A blocked task gets one correction attempt; a second failed review stops the workflow — open the task board, read the findings and resume from the last approved step.

Where do credentials live? In your user settings on your own machine; chat history lasts for the current session. Python tool validation is a guardrail, not a security sandbox.

Contributing

Spot a bug or miss a tool? Open an issue with your Blender version, Windows build and a short reproduction. Pull requests that add scene tools, interface languages or provider support are welcome. If Blender AI MCP Suite saves you clicks, leave a ⭐ star — it helps other artists find the suite.

Keywords

blender ai mcp suite · blender ai mcp · ai for blender · blender ai assistant · blender mcp server · blender mcp · model context protocol · mcp integration · ai blender addon · blender extension · blender addon · blender plugin · blender copilot · blender automation · blender scripting · blender python · bpy api · blender api · geometry nodes · 3d modeling · 3d automation · 3d workflow · ai scene builder · scene generation · ai modeling · ai materials · viewport screenshot · blender agents · blender multi-agent · ai agents 3d · blender chatgpt · blender claude · blender openai · blender gemini · blender ollama · blender openrouter · opencode blender · local llm blender · chat in blender · ai chat blender · blender workflow · product display scene · asset search blender · poly haven blender · sketchfab blender · poly pizza blender · blender export automation · blender undo checkpoint · studio workspace blender · visual chat blender · ai tools for blender · blender studio window

License

Released under the MIT license.

Blender-AI-MCP-Suite (findavoulot1973/Blender-AI-MCP-Suite)

Searching Database…

What is this?Blender AI MCP Suite is an AI assistant and built-in MCP server for Blender. You describe a scene in plain language, and it inspects the scene, plans ordered steps, and applies them as approved, reversible operations.
Is it a separate app or a Blender add-on?It is a Blender add-on, installed as an extension. It has three parts: a sidebar with chat, scene outline, and approvals; a connection manager for AI providers; and a built-in MCP server for external clients.
How do I get it running?Download the mcp-for-blender-pro.zip from Releases. In Blender, go to Edit → Preferences → Get Extensions → menu → Install from Disk, select the ZIP, and enable it. Then open 3D Viewport → N → MCP Pro, choose a provider, and select a model.
What do I need before installing?Blender 4.2 or later, and an API key from a supported provider or a local Ollama model. The model must support tool calling.
Any install pitfalls on Windows?Windows may block the downloaded ZIP. Right-click the archive, open Properties, tick Unblock, confirm, and install it again.
Does it work on macOS and Linux?The README documents installation only on Windows x64 with Blender 4.2 or later. Blender itself runs on other systems, but no steps for them are given, so macOS and Linux are unconfirmed.
Can I run it without internet?Only with a local Ollama model or a custom endpoint running on your machine. OpenAI, Claude, Gemini, and OpenRouter need internet, and asset search on Poly Haven, Sketchfab and Poly Pizza does too.
Where are my API keys stored?Keys and connection details are saved in your user settings on your own machine. Chat history lasts only for the current session.
What can the assistant actually do in a scene?It inspects objects, transforms, materials and modifiers first. It then adds primitives, lights, cameras, parenting, duplicates and materials, using 21+ scene tools. Each step is shown in chat and needs your approval.
Can the assistant check its own work?Yes, with a vision-capable model. Viewport screenshots are returned for review, and every mutating operation gets a named undo checkpoint you can roll back to.
How do the multi-agent teams work?A manager splits a large brief into assignments with acceptance criteria, workers perform the scene operations, and reviewers approve or send back findings. A blocked task gets one correction attempt, and the task board tracks every attempt.
Can external tools like OpenCode drive it?Yes. The built-in MCP server is an authenticated local Streamable HTTP endpoint, and external clients such as OpenCode use the same tool set through it. Blender must stay open.
Size
<0.1 MB
Stars
498
Age
6d
Commits · 90 Days