Skip to main content
Glama
deenesjakoruzh
tattooinmtl

Blender MCP

by tattooinmtl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Blender MCP — MiniMax Connector for Blender 5.2 LTS

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

addon/blender_mcp_addon/ → se instala en Blender

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

connector/ → se instala en C:/Users/.../.minimax/plugins/blender-mcp/

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.

Por qué este diseño

  • 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: blender-mcp-ultra

Estructura del proyecto

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

Inicio rápido

# 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. Activar en Blender

  1. Abre Blender.

  2. Ve a Editar → Preferencias → Complementos.

  3. Busca "Blender MCP" y marca la casilla para activarlo.

  4. 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).

  5. Verás [Blender MCP] Server listening on http://127.0.0.1:8765/mcp en la consola.

3. Verificación

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.

Herramientas expuestas

Herramienta

Propósito

Solo lectura

get_addon_info

Negociación de capacidades — nombre, versión, protocolo, lista de herramientas. Llámala primero.

sí

scene_info

Resumen de la escena (objetos, luces, cámaras, fotograma)

sí

list_objects

Lista los objetos de la escena, con filtro de tipo opcional

sí

get_object

Detalles completos del objeto (ubicación, rotación, escala, modificadores, materiales)

sí

create_object

Crea un primitivo (cubo, esfera, plano, cilindro, cono, toro, vacío, cámara, luz)

no

delete_object

Elimina un objeto por nombre

no

transform_object

Establece ubicación/rotación/escala

no

set_material

Crea o asigna un material con un Principled BSDF

no

set_texture

Aplica un archivo de imagen a una entrada del material (base_color, roughness, normal, etc.)

no

import_asset

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

no

add_modifier

Añade un modificador (subdivisión, simetría, solidificar, matriz, bisel)

no

remove_modifier

Elimina un modificador por nombre

no

frame_get / frame_set

Leer / mover la línea de tiempo

mixto

render_image

Renderiza el fotograma actual a un archivo

no

screenshot_viewport

Captura la vista 3D actual

no

execute_python

Ejecuta código bpy arbitrario (protegido con validación AST)

no

ping

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.

Desarrollo

# 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

Licencia

MIT. Consulta 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