Busca "Blender MCP" y obtienes guías de instalación de un proyecto que cambió de nombre, una página de directorio para cada fork y casi nada sobre el hecho de que Blender ahora tiene su propio servidor. Hay dos proyectos que importan, hacen trabajos distintos y ambos usan el mismo puerto por defecto, así que vale la pena saber cuál estás instalando.
Leímos el código fuente y la documentación de ambos proyectos el 14 de noviembre de 2026, ejecutamos MCP for Blender 2.2.9 a través de MCP Inspector en una Mac con Blender 5.2.3 instalado, y verificamos las cifras contra GitHub, PyPI y projects.blender.org ese mismo día.
Los dos servidores
| MCP for Blender | Servidor MCP de Blender Lab | |
|---|---|---|
| Quién | ahujasid y colaboradores, comunidad | Blender Lab, parte del proyecto Blender |
| Repositorio | ahujasid/mcp-for-blender (antes blender-mcp) | projects.blender.org/lab/blender_mcp |
| Licencia | MIT | GPL-3.0-or-later |
| Estrellas | 34.351 en GitHub | 37 en projects.blender.org |
| Última versión | 2.2.9 en PyPI, 13 de noviembre de 2026 | v1.0.3, 11 de septiembre de 2026 |
| Blender | 3.0 o superior | 5.1 o superior |
| Herramientas | 10 | 26 |
| Fortaleza | Construir escenas: ejecutar código, mirar el resultado, traer assets, generar modelos | Leer escenas: resúmenes, búsqueda en la documentación, capturas de pantalla, saltar a objetos |
| En Claude | Cualquier cliente mediante uvx | El conector de Blender en Claude Desktop |
Los dos funcionan igual por debajo. Blender no tiene una API de red, así que cada proyecto incluye dos partes: un add-on que abre un socket TCP dentro de Blender y un MCP server que arranca tu cliente. El cliente habla MCP con el servidor, el servidor envía comandos por el socket y el add-on los ejecuta en el hilo principal de Blender. Por eso el add-on tiene que estar habilitado y en ejecución antes de que funcione cualquier herramienta.
Cuál elegir depende de qué quieres que haga el modelo. Si quieres que modele, ilumine y vista una escena, MCP for Blender está pensado para ese ciclo: escribir Python, mirar el viewport, corregir, repetir. Si quieres ayuda para entender un archivo que te enviaron, encontrar texturas que faltan o responder "cómo hago esto en la API de Python", el servidor de Blender Lab es más acotado a propósito y trae consigo el manual y la documentación de la API de Blender.
MCP for Blender, el servidor de la comunidad
Esto es lo que la mayoría de los tutoriales llama "Blender MCP". Se publicó por primera vez en marzo de 2025, superó las 34.000 estrellas y en septiembre de 2026 pasó de llamarse blender-mcp a MCP for Blender. La nota del mantenedor sobre el cambio de nombre dice que nada se rompe: uvx blender-mcp sigue funcionando a través de un paquete de compatibilidad, la ruta de importación no cambia y el add-on es el mismo archivo. Parte de la razón que se dio fue evitar confusiones con el proyecto oficial Blender Lab. El README también deja claro que no está afiliado a la Blender Foundation.
Qué hacen sus diez herramientas
Listamos las herramientas con el CLI de MCP Inspector contra la versión 2.2.9 y obtuvimos diez, una más que la línea "nine tools" del README:
| Herramienta | Qué hace |
|---|---|
execute_blender_code |
Ejecuta Python en la sesión activa de Blender |
look |
Muestra el viewport, una cámara, una hoja multiángulo o fotogramas de animación, en modo solid, material, rendered, wireframe o x-ray |
get_scene_info |
Un resumen de texto de objetos, tamaños, materiales y estado de las mallas |
search_assets |
Busca en Poly Haven, Sketchfab y Poly Pizza |
import_asset |
Trae un asset encontrado a la escena |
generate_3d |
Genera un modelo a partir de texto o una imagen con Hyper3D Rodin, Hunyuan3D, Meshy o Tripo |
generate_gaussian_world |
Una escena de Gaussian splat de World Labs, Blender 5.3 o superior |
get_addon_status |
Versiones de Blender y del add-on, qué librerías y generadores están activos |
disable_telemetry |
Desactiva la recopilación de datos |
record_trajectory_feedback |
Envía comentarios sobre una sesión, solo si lo autorizaste |
El par que lo hace útil es execute_blender_code y look. Un modelo que solo puede escribir código está adivinando; uno que puede renderizar el viewport y ver que la silla flota 30 cm por encima del suelo puede corregirlo. Poly Haven no necesita clave y sus assets son CC0. Poly Pizza necesita una clave gratuita y cerca de dos tercios de sus modelos son CC-BY, así que debes dar crédito a los autores. Los generadores necesitan tus propias claves de API, o el plan Premium de pago que enlaza el README.
Instalarlo
Necesitas Blender 3.0 o superior, Python 3.10 o superior y uv. Instala uv con su instalador oficial o brew install uv; el README dice que no uses pip install uv.
El proyecto ofrece un instalador de una línea que canaliza un script desde su sitio web a tu shell. Funciona, pero léelo primero si haces ese tipo de cosas. La ruta manual son dos comandos y una casilla. Primero el add-on:
uvx mcp-for-blender install-addon
Eso copia blender_mcp.py en la carpeta de add-ons de Blender e imprime la ruta. Luego abre Blender, ve a Edit, Preferences, Add-ons y activa "Interface: MCP for Blender". Pulsa N en la vista 3D y abre la pestaña MCP for Blender. El servidor debería estar en ejecución; si el panel ofrece un botón para iniciarlo, haz clic en él. El README llama a ese botón de dos formas distintas en dos secciones, así que busca el nombre que muestre tu versión.
Luego agrega el servidor a tu cliente.
Claude Code
claude mcp add blender uvx mcp-for-blender
Codex
codex mcp add blender -- uvx mcp-for-blender
Claude Desktop y Cursor usan el mismo JSON. En Claude Desktop va en claude_desktop_config.json (Settings, Developer, Edit Config); en Cursor, en Settings, MCP, o .cursor/mcp.json:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"],
"env": { "DISABLE_TELEMETRY": "true" }
}
}
}
En Windows, Cursor necesita "command": "cmd" con "args": ["/c", "uvx", "mcp-for-blender"]. La línea env es opcional; está ahí por el valor predeterminado de telemetría que se describe abajo. Si quieres la misma entrada para varios clientes a la vez, nuestro config builder la escribe para cada uno.
Tampoco ejecutes uvx mcp-for-blender tú mismo en una terminal. El cliente inicia el servidor. Una segunda copia compite por el mismo Blender, y la respuesta del mantenedor en el issue 52 fue simplemente que no funcionará cuando se ejecute en más de un lugar.
Lo que vimos con Blender cerrado
Iniciamos el servidor a través de MCP Inspector con Blender sin ejecutarse. El servidor arrancó, comprobó el add-on en disco ("Blender addon on disk is current (protocol 16)") y luego registró Failed to connect to Blender: [Errno 61] Connection refused. Listar las herramientas seguía funcionando, porque la lista no necesita Blender.
Llamar a get_scene_info devolvió el texto "Could not connect to Blender. Make sure the Blender addon is running." con isError en false. Ese detalle importa si automatizas comprobaciones: el CLI de Inspector salió con 0, así que un paso de CI leería el fallo como un éxito. Revisa el texto del resultado, no solo el código de salida.
El servidor oficial de Blender Lab
Blender Lab es un espacio dentro del proyecto Blender para probar cosas nuevas, creado en febrero de 2026. Su MCP server está en projects.blender.org/lab/blender_mcp, y blender.org tiene una página para él. Cuando Anthropic anunció sus conectores para trabajo creativo el 28 de abril de 2026, dijo que los desarrolladores de Blender habían creado un conector MCP que ya está disponible oficialmente para Claude. Blender decidió aceptar la contribución de Anthropic como una donación única en lugar de canalizarla a través del Development Fund.
Sus 26 herramientas leen más de lo que escriben. Hay resúmenes de los datablocks de un archivo .blend, archivos faltantes, librerías enlazadas y rutas; resúmenes de objetos; capturas de una ventana o área; herramientas para llevar la interfaz a una pestaña u objeto; renders de miniatura y de viewport a un archivo; y búsqueda en la documentación de la API de Python de Blender y en el manual, que vienen incluidos con el servidor. Varias herramientas de archivo tienen un gemelo _for_cli que se ejecuta en un Blender en segundo plano aparte, para que el modelo pueda inspeccionar un archivo que no tienes abierto. También tiene execute_blender_code, así que también puede cambiar cosas.
Instalarlo
El add-on necesita Blender 5.1 o superior. Eso es lo que dicen blender.org y el manifiesto del add-on; el tutorial de Claude Academy de Anthropic dice 4.2, lo que parece desactualizado. Instala el add-on arrastrando el enlace de la página de blender.org a Blender dos veces: el primer arrastre agrega el repositorio de extensiones "lab", el segundo instala. Luego ve a Edit, Preferences, Add-ons, abre su pestaña e inicia el MCP server. Ahí puedes marcar el inicio automático.
En Claude Desktop no configuras nada a mano: abre Customize, Connectors, busca Blender y agrégalo. Esto es solo para Claude Desktop, no para claude.ai en el navegador, porque Blender debe ejecutarse en la misma máquina. La página de Academy dice que el plan gratuito funciona.
Para otros clientes, la página de releases tiene un paquete .mcpb, o clonas el repositorio y apuntas tu cliente a él con uv:
{
"mcpServers": {
"blender": {
"command": "uv",
"args": ["--directory", "/Users/you/blender_mcp/mcp", "run", "blender-mcp"]
}
}
}
El add-on también escucha en el puerto 9876 de localhost. Si tienes ambos add-ons habilitados, inicia solo uno a la vez, o mueve uno a otro puerto en sus preferencias.
Seguridad: lo que dicen ambos proyectos
Ambos servidores le entregan al modelo un intérprete de Python dentro de Blender. Python en Blender puede leer y borrar archivos, abrir conexiones de red y ejecutar programas, con los mismos permisos que tu cuenta de usuario. Ninguno de los dos proyectos lo oculta.
El README de MCP for Blender dice que execute_blender_code "puede ser potente pero potencialmente peligroso" y te indica, en negrita, que siempre guardes tu trabajo primero. También aclara que el socket del complemento no tiene autenticación ni cifrado, así que cualquiera que pueda alcanzar el puerto puede ejecutar Python en tu Blender. La página de Blender Lab va más allá: el código generado se ejecuta "sin ninguna protección" y recomienda usar una máquina virtual o un sistema sin datos sensibles.
Lo que haríamos en la práctica:
- Guarda y mantén versiones. Los cambios ocurren en la sesión activa. Nada se escribe en disco hasta que guardas, lo que también significa que un script defectuoso puede arruinar una hora de trabajo sin guardar. La opción Save Versions en Preferences, Save & Load es un seguro barato.
- Activa el modo seguro en MCP for Blender. Define
BLENDER_MCP_SAFE_MODE=1en elenvdel servidor. Los scripts se revisan antes de ejecutarse y se bloquean el acceso a archivos, la ejecución de otros programas, el acceso a la red y la persistencia. Está desactivado por defecto, y algunos flujos de trabajo con assets necesitan que siga así. - Mantén el socket en localhost. El complemento tiene ajustes de "Bind Address" y "Allow Remote Connections". Déjalos como están; para un Blender remoto, usa un túnel SSH.
- Pide ver el código. Para cualquier cosa que borre o renombre muchos objetos, pídele al modelo que muestre el script antes de ejecutarlo. El tutorial de Anthropic sugiere lo mismo.
- Revisa la telemetría por defecto. MCP for Blender envía por defecto un registro anónimo mínimo por cada llamada a herramienta: IDs aleatorios de instalación y de sesión, nombre de la herramienta, éxito, duración, versiones, sistema operativo y hora. Los prompts, el código, las capturas de pantalla y los datos de la escena solo se envían si marcas la casilla de consentimiento, y el README indica que los datos aceptados pueden usarse para entrenar modelos de IA.
DISABLE_TELEMETRY=truelo desactiva todo.
Para una visión más amplia de a qué puede acceder un MCP server local, consulta Seguridad en MCP.
Cuando no se conecta
Casi todos los problemas de Blender MCP son una de cuatro roturas en la cadena del cliente a Blender. Revísalas en orden.
| Lo que ves | Causa | Solución |
|---|---|---|
spawn uvx ENOENT en el log del cliente |
Las apps iniciadas desde el Dock o el menú Inicio no reciben el PATH de tu terminal | Usa la ruta completa de which uvx (por ejemplo /opt/homebrew/bin/uvx) como comando, o cmd /c uvx en Windows, y luego cierra el cliente por completo y vuelve a abrirlo |
"Could not connect to Blender", el log dice Connection refused |
Blender cerrado, add-on deshabilitado o su servidor no iniciado | Abre Blender, habilita el add-on e inicia el servidor en el panel N |
| Las herramientas fallan de forma aleatoria o la conexión se corta | Más de una copia del servidor; un usuario del issue 52 encontró cuatro tras iniciar solo Claude Desktop | Déjalo en un solo cliente o cierra el otro; busca procesos mcp-for-blender sueltos |
| El servidor se cae al iniciar con un error de Python | Se tomó el Python de conda o pyenv, o un CPython nuevo sin wheels | Añade "--python", "3.11" antes del nombre del paquete en args y "UV_PYTHON_PREFERENCE": "only-managed" en env |
| Comportamiento antiguo tras una actualización | Caché de uv | uv cache clean mcp-for-blender blender-mcp, luego uvx --refresh mcp-for-blender |
| El servidor en Docker o en un dev container no puede llegar a Blender | localhost dentro del contenedor es el contenedor |
Define BLENDER_HOST=host.docker.internal en macOS y Windows; en Linux usa --network=host |
| Blender se congela al importar | Las descargas de Poly Haven se ejecutan en el hilo principal de Blender | Espera; vuelve cuando termina la descarga |
| Dos ventanas de Blender, una ignorada | Ambos add-ons en 9876 | Asigna otro puerto al segundo add-on e inicia un segundo servidor con --port |
El README también admite que el primer comando tras conectar a veces falla y el segundo funciona. Si sigue fallando, reinicia tanto el cliente como el servidor en Blender antes de cambiar cualquier otra cosa.
Otros servidores MCP para Blender
Existen muchos forks. En GitHub, el 14 de noviembre de 2026, los que tienen un historial real después de MCP for Blender eran dhakalnirajan/blender-open-mcp (123 estrellas, MIT), creado para modelos locales a través de Ollama, LM Studio o llama.cpp y que usa el mismo puerto del add-on; pranav-deshmukh/blender-mcp (99 estrellas, MIT, último push en agosto de 2025); y bpy-dev/blender-mcp (97 estrellas, GPL-3.0), un reempaquetado del servidor de Blender Lab.
Dejamos fuera un grupo de repositorios con nombres casi idénticos y unas 200 estrellas cada uno, todos con push el 12 de noviembre de 2026, uno de ellos creado ese mismo día. Unos recuentos de estrellas que aparecen en dos días parecen comprados, y un add-on ejecuta código dentro de Blender. Si un proyecto de Blender MCP es nuevo, revisa su historial de commits y quién contribuye antes de instalarlo.
La lista completa de servidores que mencionan Blender, con las puntuaciones de checks y los comandos de instalación, está en la tabla al principio de esta página.
Cuál instalar
- Quieres que un agente cree o modifique escenas, en cualquier cliente: MCP for Blender. Activa el modo seguro en cuanto sepas qué flujos de trabajo necesitan desactivarlo.
- Usas Claude Desktop y sobre todo quieres respuestas sobre tu archivo o la API: el conector oficial de Blender. Son dos clics, y su búsqueda en la documentación mantiene las respuestas ligadas a la API real de Blender.
- Ejecutas un modelo local: blender-open-mcp, o MCP for Blender en un cliente que admita tu backend local.
- Tienes una versión de Blender anterior a la 5.1: MCP for Blender es el único de los dos que se cargará.
Elijas lo que elijas, el primer prompt útil es el mismo: pide al modelo que describa la escena antes de cambiar nada. Si puede hacerlo, toda la cadena funciona.