[](LICENSE)
[](https://www.python.org/downloads/)
[](https://www.blender.org/)
[](https://modelcontextprotocol.io)
[](https://github.com/RFingAdam/eng-mcp-suite)
**Control Blender from any MCP client: 218 tools across modeling, materials, sculpting, animation, AI 3D generation, and MSFS content creation.**
**Drive it from your IDE, terminal, or AI agent and run an iterative render-analyze-refine loop without leaving Blender.**
[Quick start](#quick-start) ·
[Tools](#tools) ·
[Self-refinement loop](#self-refinement-loop) ·
[Workflows](#workflows) ·
[Documentation](#documentation)
> Supports **Blender 4.2 LTS** and **Blender 5.0**.
---
## What is mcp-blender?
`mcp-blender` is an MCP server that exposes 218 Blender tools to any
MCP-compatible AI client (Claude Desktop, Claude Code, Codex CLI, …).
The MCP server speaks the Model Context Protocol over stdio; a Blender
addon listens on a local TCP socket and dispatches into Blender's
`bpy` API on the main thread via `bpy.app.timers`.
```
┌─────────────────┐ stdio ┌─────────────────┐ TCP/JSON-RPC ┌─────────────────┐
│ MCP client │ ◄──────────► │ MCP Server │ ◄──────────────► │ Blender Addon │
│ (Claude / …) │ │ (Python proc) │ port 9876 │ (bpy.app.timers)│
└─────────────────┘ └─────────────────┘ └─────────────────┘
```
**What it does well:**
- **AI-native via MCP.** First-class [Model Context Protocol](https://modelcontextprotocol.io)
server with **218 tools** across every Blender pipeline stage.
- **End-to-end coverage.** Scene, object, mesh, material, modifier,
animation, render, export, baking, geometry nodes, sculpting, rigging,
physics, annotations.
- **MSFS-ready.** Full **Microsoft Flight Simulator 2020 / 2024**
content pipeline: LOD hierarchies, collision meshes, MSFS materials,
animation tags, livery painting + transfer for FBW / Fenix / PMDG /
iniBuilds / Aerosoft.
- **AI 3D generation.** Multi-backend (Hyper3D Rodin, Meshy, Tripo,
TripoSR, Stable Fast 3D, Hunyuan3D, ComfyUI) text/image-to-3D with
auto mesh cleanup and decimation.
- **Self-refinement loop.** `render_multi_angle` -> `analyze_viewport`
-> `refine_iteration` against an Ollama vision model converges geometry
toward a target prompt.
- **Poly Haven built-in.** Free HDRIs, textures, and models with no
API key.
- **MIT licensed.**
---
## Quick start
### 1. Install the MCP server
The `mcp-blender` package on PyPI is an unrelated project; install this one from GitHub.
```bash
pip install "mcp-blender @ git+https://github.com/RFingAdam/mcp-blender.git"
```
Or from source:
```bash
git clone https://github.com/RFingAdam/mcp-blender
cd mcp-blender
pip install -e .
```
### 2. Install the Blender addon
**Option A: from ZIP (recommended):**
1. Download `blender_mcp_addon.zip` from the [releases page](https://github.com/RFingAdam/mcp-blender/releases).
2. In Blender: **Edit -> Preferences -> Add-ons -> Install…**
3. Select the ZIP, enable "MCP Server Addon".
**Option B: from source:**
```bash
# Linux
ln -s /path/to/mcp-blender/addon/blender_mcp_addon \
~/.config/blender/4.2/scripts/addons/
# macOS
ln -s /path/to/mcp-blender/addon/blender_mcp_addon \
~/Library/Application\ Support/Blender/4.2/scripts/addons/
# Windows (admin)
mklink /D "%APPDATA%\Blender Foundation\Blender\4.2\scripts\addons\blender_mcp_addon" ^
"C:\path\to\mcp-blender\addon\blender_mcp_addon"
```
Then enable the addon in Blender preferences.
### 3. Configure your MCP client
```json
{
"mcpServers": {
"blender": {
"command": "mcp-blender",
"args": ["--port", "9876"]
}
}
}
```
### 4. Three surfaces, same loop