Un puente del Model Context Protocol que permite a MiniMax Code (y a cualquier cliente MCP) controlar Blender 5.2 LTS mediante lenguaje natural. Se distribuye como dos artefactos:
Artefacto | Qué es | Dónde se instala |
Blender add-on | Add-on de Python que ejecuta un servidor MCP Streamable-HTTP dentro de Blender en un hilo en segundo plano |
|
MiniMax Plugin V1 | Plugin local de MiniMax Code que se conecta al servidor MCP de Blender en ejecución y expone sus herramientas al agente |
|
El add-on de Blender es la fuente de verdad del estado del lado de Blender. El plugin de MiniMax es un cliente ligero que llama al endpoint HTTP del add-on — no se lanza ningún proceso Python en el lado de MiniMax, así que no hay fugas de puertos ni líos con el ciclo de vida.
Una única ruta de instalación dentro de Blender — el servidor MCP se ejecuta en el propio proceso usando bpy, de modo que no hay que hacer malabares con uvx/pipx ni mantener un par de sockets sincronizados.
Streamable HTTP en localhost — funciona con cualquier cliente MCP moderno (MiniMax Code, Claude Desktop, Cursor) y sobrevive a los reinicios de Blender.
Servidor MCP hecho a mano en el add-on — Blender 5.2 LTS incluye Python 3.13 sin paquetes externos por defecto. Un servidor MCP de ~300 líneas es más portátil que arrastrar mcp[cli] y editar sys.path.
MiniMax Plugin V1 con la capacidad streamable-http — el plugin no lanza ningún proceso; simplemente apunta al endpoint del add-on de Blender.
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.ps1Abre Blender.
Ve a Editar → Preferencias → Complementos.
Busca "Blender MCP" y marca la casilla para activarlo.
Configura el puerto (por defecto 8765) y haz clic en Start Server (o inícialo desde la barra lateral de la Vista 3D, en la pestaña Blender MCP).
Verás [Blender MCP] Server listening on http://127.0.0.1:8765/mcp en la consola.
En un chat de MiniMax Code, pregunta:
Usa el conector de Blender: lista los primeros 5 objetos de la escena actual.
Deberías ver cómo el agente llama a tools/list contra tu Blender en ejecución.
Herramienta | Propósito | Solo lectura |
| Negociación de capacidades — nombre, versión, protocolo, lista de herramientas. Llámala primero. | sí |
| Resumen de la escena (objetos, luces, cámaras, fotograma) | sí |
| Lista los objetos de la escena, con filtro de tipo opcional | sí |
| Detalles completos del objeto (ubicación, rotación, escala, modificadores, materiales) | sí |
| Crea un primitivo (cubo, esfera, plano, cilindro, cono, toro, vacío, cámara, luz) | no |
| Elimina un objeto por nombre | no |
| Establece ubicación/rotación/escala | no |
| Crea o asigna un material con un Principled BSDF | no |
| Aplica un archivo de imagen a una entrada del material (base_color, roughness, normal, etc.) | no |
| Importa GLB/GLTF/FBX/OBJ/STL/PLY/DAE/USD/X3D/ABC | no |
| Añade un modificador (subdivisión, simetría, solidificar, matriz, bisel) | no |
| Elimina un modificador por nombre | no |
| Leer / mover la línea de tiempo | mixto |
| Renderiza el fotograma actual a un archivo | no |
| Captura la vista 3D actual | no |
| Ejecuta código | no |
| Comprobación de salud | sí |
El plugin de MiniMax también incluye una Skill (blender-mcp-quickstart) que ofrece al agente un índice de herramientas de un vistazo, reglas de seguridad y recetas comunes. Léela antes de hacer algún trabajo no trivial.
Consulta docs/tools_reference.md para ver el esquema completo y ejemplos.
# 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. Consulta 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