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 |
|
MiniMax Plugin V1 | Lokales MiniMax-Code-Plugin, das sich mit dem laufenden Blender-MCP-Server verbindet und seine Werkzeuge dem Agenten bereitstellt |
|
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.
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: BlenderMCP
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# 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Öffnen Sie Blender.
Gehen Sie zu Bearbeiten → Einstellungen → Add-ons.
Suchen Sie nach "Blender MCP" und aktivieren Sie das Kontrollkästchen, um das Add-on zu aktivieren.
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).
Sie sehen in der Konsole die Ausgabe [Blender MCP] Server listening on http://127.0.0.1:8765/mcp.
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.
Werkzeug | Zweck | Nur Lesen |
| Fähigkeiten-Handshake — Name, Version, Protokoll, Werkzeugliste. Diesen zuerst aufrufen. | Ja |
| Szenenübersicht (Objekte, Lichter, Kameras, Frame) | Ja |
| Szenenobjekte auflisten, optionaler Typfilter | Ja |
| Vollständige Objektdetails (Position, Rotation, Skalierung, Modifier, Materialien) | Ja |
| Primitive erstellen (Würfel, Kugel, Ebene, Zylinder, Kegel, Torus, Empty, Kamera, Licht) | Nein |
| Ein Objekt über den Namen löschen | Nein |
| Position/Rotation/Skalierung festlegen | Nein |
| Material mit Principled BSDF erstellen oder zuweisen | Nein |
| Bilddatei auf einen Materialeingang anwenden (base_color, roughness, normal usw.) | Nein |
| GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC importieren | Nein |
| Modifier hinzufügen (Subdivision, Mirror, Solidify, Array, Bevel) | Nein |
| Modifier nach Name entfernen | Nein |
| Timeline lesen / verschieben | Gemischt |
| Aktuelles Frame in eine Datei rendern | Nein |
| Aktuelles Viewport erfassen | Nein |
| Beliebigen | Nein |
| 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.
# 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/ -vMIT. Siehe LICENSE.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for Producer/Riffusion AI music generation
MCP server for Hailuo (MiniMax) AI video generation
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tattooinmtl/Minimax_Blender_MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server