Skip to main content
Glama
deenesjakoruzh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Blender MCP — MiniMax Connector for Blender 5.2 LTS

Eine Model Context Protocol Bridge, die es MiniMax Code (und jedem MCP-Client) ermöglicht, Blender 5.2 LTS über natürliche Sprache zu steuern. Das Projekt wird als zwei Artefakte ausgeliefert:

Artefakt

Zweck

Speicherort

Blender add-on

Python-Add-on, das einen MCP-Streamable-HTTP-Server innerhalb von Blender auf einem Hintergrundthread ausführt

addon/blender_mcp_addon/ → wird in Blender installiert

MiniMax Plugin V1

Lokales MiniMax-Code-Plugin, das sich mit dem laufenden Blender-MCP-Server verbindet und seine Werkzeuge dem Agenten bereitstellt

connector/ → wird in C:/Users/.../.minimax/plugins/blender-mcp/ installiert

Das Blender-Add-on ist die maßgebliche Quelle für den Blender-seitigen Zustand. Das MiniMax-Plugin ist ein schlanker Client, der den HTTP-Endpunkt des Add-ons aufruft — auf der MiniMax-Seite wird kein Python-Prozess gestartet, daher gibt es weder ein Port-Leck noch ein Lebenszyklus-Chaos.

Warum dieser Aufbau

  • Ein einziger Installationspfad innerhalb von Blender — der MCP-Server läuft prozessintern mit bpy, sodass es kein uvx/pipx-Hin und Her gibt und kein Socket-Paar synchron gehalten werden muss.

  • Streamable HTTP auf localhost — funktioniert mit jedem modernen MCP-Client (MiniMax Code, Claude Desktop, Cursor) und übersteht Neustarts von Blender.

  • Handgeschriebener MCP-Server im Add-on — Blender 5.2 LTS bündelt Python 3.13 standardmäßig ohne externe Pakete. Ein MCP-Server von rund 300 Zeilen ist portabler, als mcp[cli] einzubinden und sys.path anzupassen.

  • MiniMax Plugin V1 mit streamable-http-Fähigkeit — das Plugin startet nichts; es verweist lediglich auf den Endpunkt des Blender-Add-ons.

Related MCP server: blender-mcp-ultra

Projektstruktur

blender_addon_mcp/
├── README.md                      ← you are here
├── LICENSE                        ← MIT
├── pyproject.toml                 ← dev tooling for the add-on (ruff, mypy, pytest)
├── .gitignore
├── addon/
│   └── blender_mcp_addon/         ← zips into a Blender-installable .zip
│       ├── __init__.py            ← bl_info, register/unregister
│       ├── preferences.py         ← AddOnPreferences (port, auth token, autostart)
│       ├── server/
│       │   ├── __init__.py
│       │   ├── mcp_server.py      ← MCP protocol (initialize, tools/list, tools/call, ping)
│       │   ├── transport.py       ← stdlib http.server, runs on a daemon thread
│       │   └── protocol.py        ← JSON-RPC 2.0 + MCP 2025-03-26 types
│       ├── tools/
│       │   ├── __init__.py        ← tool registry
│       │   ├── scene.py           ← scene_info, frame control
│       │   ├── objects.py         ← list, get, create, delete, transform
│       │   ├── materials.py       ← create, assign, modify
│       │   ├── modifiers.py       ← add, set params, remove
│       │   ├── render.py          ← render_image, screenshot_viewport
│       │   └── code.py            ← execute_python (with confirmation)
│       └── utils/
│           ├── __init__.py
│           ├── bpy_helpers.py     ← bpy → JSON serialization
│           └── safe_eval.py       ← ast-validated code execution
├── connector/                     ← MiniMax Plugin V1 source
│   ├── .minimax-plugin/
│   │   └── plugin.json
│   ├── servers/
│   │   └── blender.mcp.json       ← streamable-http → http://127.0.0.1:8765/mcp
│   ├── icon.png                   ← category icon (Design / 3D)
│   └── README.md
├── scripts/
│   ├── install_addon.ps1          ← zip and install into Blender
│   └── install_connector.ps1      ← copy connector into ~/.minimax/plugins/
├── examples/
│   ├── basic_scene.md
│   ├── material_setup.md
│   └── render_workflow.md
└── docs/
    ├── architecture.md
    ├── blender_5_2_notes.md
    └── tools_reference.md

Schnellstart

# 1. Clone the repository
git clone https://github.com/tattooinmtl/Minimax_Blender_MCP.git
cd Minimax_Blender_MCP

# 2. Install the Blender add-on
pwsh ./scripts/install_addon.ps1

# 3. Install the MiniMax connector plugin
pwsh ./scripts/install_connector.ps1

4. In Blender aktivieren

  1. Öffnen Sie Blender.

  2. Gehen Sie zu Bearbeiten → Einstellungen → Add-ons.

  3. Suchen Sie nach "Blender MCP" und aktivieren Sie das Kontrollkästchen, um das Add-on zu aktivieren.

  4. Legen Sie den Port fest (Standard 8765) und klicken Sie auf Start Server (oder starten Sie ihn über die Seitenleiste des 3D-Viewports unter dem Tab Blender MCP).

  5. Sie sehen in der Konsole die Ausgabe [Blender MCP] Server listening on http://127.0.0.1:8765/mcp.

3. Überprüfen

Fragen Sie in einem MiniMax-Code-Chat:

Verwende den Blender-Connector: Liste die ersten 5 Objekte in der aktuellen Szene auf.

Sie sollten sehen, wie der Agent tools/list gegen Ihr laufendes Blender aufruft.

Verfügbare Werkzeuge

Werkzeug

Zweck

Nur Lesen

get_addon_info

Fähigkeiten-Handshake — Name, Version, Protokoll, Werkzeugliste. Diesen zuerst aufrufen.

Ja

scene_info

Szenenübersicht (Objekte, Lichter, Kameras, Frame)

Ja

list_objects

Szenenobjekte auflisten, optionaler Typfilter

Ja

get_object

Vollständige Objektdetails (Position, Rotation, Skalierung, Modifier, Materialien)

Ja

create_object

Primitive erstellen (Würfel, Kugel, Ebene, Zylinder, Kegel, Torus, Empty, Kamera, Licht)

Nein

delete_object

Ein Objekt über den Namen löschen

Nein

transform_object

Position/Rotation/Skalierung festlegen

Nein

set_material

Material mit Principled BSDF erstellen oder zuweisen

Nein

set_texture

Bilddatei auf einen Materialeingang anwenden (base_color, roughness, normal usw.)

Nein

import_asset

GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC importieren

Nein

add_modifier

Modifier hinzufügen (Subdivision, Mirror, Solidify, Array, Bevel)

Nein

remove_modifier

Modifier nach Name entfernen

Nein

frame_get / frame_set

Timeline lesen / verschieben

Gemischt

render_image

Aktuelles Frame in eine Datei rendern

Nein

screenshot_viewport

Aktuelles Viewport erfassen

Nein

execute_python

Beliebigen bpy-Code ausführen (durch ast-Validierung abgesichert)

Nein

ping

Systemgesundheitsstatus

Ja

Das MiniMax-Plugin enthält außerdem eine Skill (blender-mcp-quickstart), die dem Agenten eine Werkzeugübersicht auf einen Blick, Sicherheitsregeln und gängige Rezepte bietet. Lesen Sie sie, bevor Sie nichttriviale Arbeiten durchführen.

Das vollständige Schema und Beispiele finden Sie in docs/tools_reference.md.

Entwicklung

# syntax-check the add-on (Blender's Python is at <blender>/python/bin/python.exe)
python -m py_compile addon/blender_mcp_addon/__init__.py
python -m py_compile addon/blender_mcp_addon/server/mcp_server.py
# ...etc

# lint
ruff check addon/
mypy addon/

# test the MCP server in isolation (no bpy required)
pytest addon/tests/ -v

Lizenz

MIT. Siehe LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Blender MCP VXAI

    VxASI
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables natural language control of Blender 3D through MCP clients, allowing creation, modification, and manipulation of 3D models, animations, and scenes.
    300
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables any MCP client to drive Blender 5.2 LTS through natural language, with tools for scene inspection, object creation and transformation, material and modifier handling, rendering, viewport capture, and guarded Python execution.
    1
    MIT

  • Blender MCP

    tattooinmtl
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables any MCP client to control Blender 5.2 LTS via natural language, including scene creation, object manipulation, material assignment, rendering, and Python execution.
    1
    MIT