Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/MITHRAN-BALACHANDER/Blender-MCP-antigravity.git
cd Blender-MCP-antigravity
pip install -r requirements.txtRegister it in Claude Code
claude mcp add blender-mcp-bridge -- python C:/path/to/Blender-MCP-antigravity/antigravity_blender_server.pyReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
blender-mcp-bridge's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Extract dominant colors from images to create 3D models with matching materials
- Run any Blender Python code remotely through MCP
- Query detailed information about objects, materials, and collections
- Receive live progress status during script execution
- Thread-safe architecture for reliable remote control
Tools 2
image_to_3d_modelCreate a 3D model with colors extracted from an image.blender_execExecute Blender Python code remotely.Try it
Original README from MITHRAN-BALACHANDER/Blender-MCP-antigravity
🎨 Blender MCP Bridge
AI-powered Blender control via Model Context Protocol (MCP)
Send images to create 3D models with matching colors, execute Python scripts, and control Blender remotely through Antigravity or any MCP-compatible AI client.
✨ Features
| Feature | Description |
|---|---|
| 🖼️ Image to 3D | Extract dominant colors from images and create 3D models with matching materials |
| 🐍 Script Execution | Run any Blender Python code remotely through MCP |
| 📊 Scene Query | Get detailed information about objects, materials, and collections |
| ⚡ Real-time Updates | Receive live progress status during script execution |
| 🔒 Thread-safe | Robust architecture with guaranteed responses and no deadlocks |
🏗️ Architecture
┌─────────────────────┐ MCP/stdio ┌─────────────────────────┐
│ Antigravity │◄─────────────────────►│ antigravity_blender_ │
│ (or any MCP AI) │ │ server.py │
└─────────────────────┘ └───────────┬─────────────┘
│
│ TCP Socket
│ (port 8081)
▼
┌─────────────────────────┐
│ blender_server.py │
│ (runs inside Blender) │
└─────────────────────────┘
📦 Installation
Prerequisites
- Python 3.10+
- Blender 4.2+ (with full path accessible)
- pip (Python package manager)
Quick Install
# Clone the repository
git clone https://github.com/MITHRAN-BALACHANDER/Blender-MCP-antigravity.git
cd Blender-MCP-antigravity
# Create virtual environment (recommended)
python -m venv venv
.\venv\Scripts\activate # Windows
source venv/bin/activate # Linux/Mac
# Install dependencies
pip install -r requirements.txt
Install as Package (Optional)
pip install -e .
🔌 Antigravity Integration
Add the following to your Antigravity MCP server configuration:
Option A: Direct Path
{
"mcpServers": {
"blender": {
"command": "python",
"args": ["C:/path/to/Blender-MCP-antigravity/antigravity_blender_server.py"],
"env": {}
}
}
}
Option B: Using Virtual Environment
{
"mcpServers": {
"blender": {
"command": "C:/path/to/Blender-MCP-antigravity/venv/Scripts/python.exe",
"args": ["C:/path/to/Blender-MCP-antigravity/antigravity_blender_server.py"],
"env": {}
}
}
}
Note: Replace
C:/path/to/with your actual installation path.
🚀 Quick Start
Step 1: Start Blender Server
# Navigate to project directory
cd Blender-MCP-antigravity
# Start Blender with the socket server
# Windows (use full path if 'blender' is not in PATH)
"C:\Program Files\Blender Foundation\Blender 4.2\blender.exe" --background --python blender_server.py
# Linux/Mac
blender --background --python blender_server.py
Expected output:
==================================================
[BlenderMCP] Server running on 127.0.0.1:8081
[BlenderMCP] Waiting for connections...
==================================================
Step 2: Connect Antigravity
Once Blender is running, Antigravity will automatically connect via the MCP configuration.
Step 3: Create 3D Content
Ask Antigravity to create 3D content:
"Create a low-poly island scene in Blender"
"Create a 3D model from this image" (with attached image)
🛠️ MCP Tools Reference
`image_to_3d_model`
Create a 3D model with colors extracted from an image.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
image_data |
string | ✅ | - | Base64-encoded image |
model_type |
string | ❌ | "cube" |
Shape: cube, sphere, cylinder |
model_name |
string | ❌ | "ImageModel" |
Name for the object |
Response:
{
"status": "ok",
"colors": ["#3A7D8C", "#D4C4A0", "#4A6E4A"],
"object_name": "ImageModel"
}
`blender_exec`
Exec