Qué es Blender MCP
MCP (Model Context Protocol) da a un agente herramientas que actúan sobre otro programa. Los dos proyectos de Blender MCP tienen las mismas dos partes: un add-on que ejecuta un pequeño servidor dentro de Blender y un servidor MCP que inicia tu agente y que reenvía sus llamadas de herramientas al add-on como JSON a través de un socket TCP.
El proyecto al que se refiere la mayoría es mcp-for-blender. Su README empieza con un aviso de que es una integración de terceros y que no la ha creado Blender. Tiene licencia MIT, contaba con 35.153 estrellas en GitHub el 21 de noviembre de 2026 y su paquete de PyPI cambió de nombre de blender-mcp a mcp-for-blender (versión 2.3.1 del 18 de noviembre); uvx blender-mcp sigue iniciando el servidor, así que las configuraciones antiguas siguen funcionando.
blender_mcp, de Blender Lab, es el oficial. Su readme lo describe como un servidor ligero, deliberadamente pequeño, pensado para una interfaz en lenguaje natural con la API de Python de Blender, un mejor acceso a la documentación y la exploración de escenas complejas. Aparece en el directorio de conectores de Claude como Blender, creado por Blender Lab, verificado por Anthropic.
mcp-for-blender frente a blender_mcp de Blender Lab
Cifras de los repositorios de GitHub y projects.blender.org del 21 de noviembre de 2026.
| mcp-for-blender (comunidad) | blender_mcp (Blender Lab) | |
|---|---|---|
| Creado por | Siddharth Ahuja; sin afiliación con la Blender Foundation | Blender Lab, parte del proyecto Blender |
| Licencia | MIT | GPL-3.0 |
| Versión de Blender | 3.0 o posterior | 5.1 o posterior |
| Estrellas | 35.153 en GitHub | 39 en projects.blender.org |
| Herramientas | Nueve, entre ellas execute_blender_code, look (vistas del viewport y de la cámara), get_scene_info, búsqueda e importación de assets (Poly Haven, Sketchfab, Poly Pizza) y generate_3d (Tripo, Hunyuan3D, Hyper3D Rodin, Meshy) | execute_blender_code, execute_blender_code_for_cli (Blender en segundo plano), resúmenes de archivos .blend y de objetos, get_python_api_docs, capturas de pantalla; incluye fragmentos de la API de Python y del manual |
| Instalación | Instalador de un comando o uvx mcp-for-blender; configuración integrada para Claude Code, Codex, Cursor y otros | git clone del repositorio y ejecutarlo con uv; añadir el add-on en Blender |
| Ideal para | Construir y decorar escenas, traer assets, generar modelos | Inspeccionar archivos y consultar la API de Blender, con la versión actual de Blender |
Instalación rápida: todos tus agentes a la vez
La ruta que recomienda el README de mcp-for-blender es un solo comando. Instala uv si hace falta, detecta los clientes MCP de tu máquina (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), te deja elegir cuáles configurar y después instala y habilita el add-on de Blender. Solo añade una entrada blender a cada configuración y guarda un .bak de cada archivo que modifica. Después, cierra del todo tu agente y vuelve a abrirlo.
Los comandos de abajo están copiados del README; no los hemos ejecutado. Pasar un script a tu shell lo ejecuta con tus permisos, así que si prefieres ver cada paso, usa la configuración manual de las dos secciones siguientes.
- macOS / Linux:
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh - Windows (PowerShell):
irm https://www.mcp-for-blender.com/install.ps1 | iex - Con uv ya instalado:
uvx mcp-for-blender setup - Necesitas Blender 3.0 o posterior, Python 3.10 o posterior y uv.
Instalar Blender MCP en Claude Code
Configuración manual de mcp-for-blender. Los comandos están copiados del README del proyecto y de la documentación de MCP de Claude Code; no los hemos ejecutado.
Instala uv
uv proporciona el comando
uvxque inicia el servidor. El README desaconsejapip install uv; usa el instalador oficial.# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -eRegistra el servidor
Esto guarda el servidor para el proyecto actual. Añade
--scope userpara usarlo en todas partes; las opciones de este tipo van antes de un--que las separa del comando del servidor, que es la forma que usa la documentación de Claude Code. Dentro de una sesión,/mcpmuestra el mismo estado.# el comando del README claude mcp add blender uvx mcp-for-blender # compruébalo: el servidor debe aparecer como conectado claude mcp list claude mcp get blenderOpcional: desactiva la telemetría
El README indica que se establezca
DISABLE_TELEMETRY=trueen el entorno del servidor para desactivar la telemetría por completo.claude mcp addde Claude Code admite variables de entorno con--env; consulta la documentación de MCP de Claude Code para ver la forma exacta.Instala y habilita el add-on de Blender
Luego, en Blender, abre Edit → Preferences → Add-ons y habilita "Interface: MCP for Blender". Pulsa N en el viewport 3D y abre la pestaña MCP for Blender; el servidor se inicia con Blender y, si no está en marcha, haz clic en Start MCP Server.
# copia el add-on a la carpeta de add-ons de Blender como blender_mcp.py (guarda un .bak) uvx mcp-for-blender install-addon # muestra las carpetas de add-ons que encontró uvx mcp-for-blender addon-paths
Instalar Blender MCP en Codex
La CLI de Codex, la app de escritorio y la extensión para IDE comparten ~/.codex/config.toml, así que una sola configuración cubre las tres. Los comandos están copiados del README y de la documentación de MCP de Codex de OpenAI; no los hemos ejecutado. Instala uv y el add-on de Blender como en los pasos de Claude Code.
Añade el servidor con la CLI
Codex muestra las herramientas la próxima vez que se inicia;
/mcpen la interfaz de terminal de Codex lista los servidores activos. En la app de escritorio es Settings → MCP servers → Add server, nombreblender, STDIO, comandouvx mcp-for-blender.# el comando del README codex mcp add blender -- uvx mcp-for-blender # compruébalo: blender debe aparecer como habilitado codex mcp listO edita config.toml
La tabla
[mcp_servers.blender]es del README. La líneaenvsigue la documentación de Codex, que enumeraenv,startup_timeout_sec(10 por defecto) ytool_timeout_sec(60 por defecto) como claves de la tabla; aumentatool_timeout_secsi las operaciones largas de Blender agotan el tiempo.# o a mano en ~/.codex/config.toml (lo comparten la CLI de Codex, la app de escritorio y la extensión para IDE) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]Opcional: el plugin de Codex
El README lo recomienda para Codex: muestra un viewport de Blender en vivo dentro del chat, selectores con miniaturas para los assets y menciones con @ para los objetos de la escena. Todavía no está en el directorio de plugins de Codex, así que se añade desde el repositorio.
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # luego reinicia Codex e instala "MCP for Blender" desde el directorio de plugins
Instalar en su lugar el servidor oficial de Blender Lab
El wiki de configuración de Blender Lab indica instalar su add-on en Blender 5.1 o posterior, clonar el servidor en tu carpeta personal y apuntar tu cliente MCP a él con uv. Este es el comando de clonado y la configuración del wiki tal como los registramos; no los hemos ejecutado. Si usas Claude, el servidor también aparece en el directorio de conectores de Claude, que indica que el add-on es necesario.
git clone https://projects.blender.org/lab/blender_mcp.git, y después {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}
No registres los dos proyectos con el mismo nombre blender. El README de mcp-for-blender también indica que se ejecute una sola instancia de su servidor a la vez, por ejemplo en Cursor o en Claude Desktop, pero no en ambos.
Ejemplo: un agente construye un objeto low-poly y exporta un GLB
Con Blender abierto y el add-on en marcha, el agente hace el modelado con execute_blender_code y revisa su trabajo con look. Lo escribimos a partir de la documentación y no lo ejecutamos de principio a fin, así que los resultados variarán. Para comprimir el GLB con glTF-Transform y cargarlo en three.js, consulta la guía completa de Blender MCP en vibegamer.io.
Guarda tu archivo .blend
El agente edita directamente tu archivo abierto. La advertencia del README es guardar siempre tu trabajo antes de usar
execute_blender_code.Dale la indicación al agente
Indica medidas, un presupuesto de triángulos y la ruta de exportación. Los colores base lisos se exportan sin problemas, ya que el exportador glTF de Blender lee el color base del nodo Principled BSDF. El README también señala que las operaciones complejas pueden requerir dividirse en pasos más pequeños.
Usa las herramientas de Blender MCP. Construye una caja de madera low-poly para un juego de navegador: - Cubo de 1 m, apoyado en el suelo en z = 0, con el origen en el centro de la base. - Tablones biselados y refuerzos en las esquinas, menos de 800 triángulos. - Solo colores base con Principled BSDF (madera, metal oscuro), sin texturas de imagen. - Aplica los modificadores, une todo en un solo objeto llamado "Crate". - Revísalo con la herramienta look desde varios ángulos y corrige lo que quede flotando. - Selecciona solo "Crate" y expórtalo como GLB a ./public/models/crate.glb. Muéstrame cada script antes de ejecutarlo.Lee el script de exportación antes de que se ejecute
La exportación suele terminar con una llamada como esta, con parámetros de la API
export_scenede Blender. GLB reúne malla, materiales y texturas en un solo archivo. Comprueba que la ruta esté dentro de tu proyecto.import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # un solo archivo binario con malla, materiales e imágenes use_selection=True, # solo el "Crate" seleccionado export_apply=True, # aplica los modificadores al exportar export_yup=True, # +Y arriba )
¿Es seguro Blender MCP? Qué conviene bloquear
Trátalo como si le dieras al agente una consola de Python dentro de Blender. Estos puntos son del README de mcp-for-blender.
- Python arbitrario:
execute_blender_codeejecuta cualquier Python que escriba el agente. El README lo califica de potencialmente peligroso y dice que guardes siempre tu trabajo antes. Lee los scripts antes de aprobarlos. - Modo seguro: establece
BLENDER_MCP_SAFE_MODE=1para validar los scripts antes de que se ejecuten. Bloquea la lectura y escritura directa de archivos, la ejecución de otros programas, el acceso a la red y el código persistente; el modelado, los materiales, el renderizado, el guardado y la importación/exportación siguen funcionando. - Sin autenticación en el socket: el servidor del add-on (puerto 9876 por defecto) no tiene autenticación ni cifrado, así que cualquiera que pueda llegar a ese puerto puede ejecutar Python en Blender. Mantén
BLENDER_HOSTenlocalhostsalvo que estés en una red de confianza. - Telemetría: por defecto envía un ID de instalación anónimo, un ID de sesión, el nombre de la herramienta, el éxito, la duración, las versiones, el sistema operativo y la marca de tiempo. Los prompts, el código generado, las capturas de pantalla y los datos de la escena solo se envían si lo aceptas, y los datos aceptados pueden usarse para entrenar modelos de IA. Establece
DISABLE_TELEMETRY=truepara desactivarla por completo. - Claves de terceros: la generación 3D y algunas fuentes de assets usan claves de API pasadas como variables de entorno (por ejemplo
BLENDERMCP_MESHY_API_KEY). Los modelos de Poly Pizza son CC-BY en torno a un 69 %, así que hay que dar crédito salvo que filtres por CC0.
¿Blender MCP o una skill de Blender?
Un servidor MCP da al agente una conexión en vivo con un Blender en ejecución. Una skill le da instrucciones y scripts escritos para un flujo de trabajo, como EL4CTEO/blender-skills (28 skills de flujos de trabajo de Blender 5.2 LTS+ para Claude Code, Codex y otros). Funcionan bien juntos: la skill le dice al agente cómo construir un asset listo para juegos y el servidor MCP le permite hacerlo en tu escena abierta.
Listamos skills de Blender y de creación de juegos, y servidores MCP, en game development skills, y vibegamer.io los compara en game dev agent skills.
Crewmark: un artista 3D en el mismo tablero que tus programadores
Blender MCP está pensado en torno a una sesión cada vez: tú das la indicación, el agente modela, tú revisas. Si quieres un agente que siga creando assets durante días mientras otros escriben el código del juego, Crewmark es otra opción.
En Crewmark cada agente es un empleado de IA: una sesión de larga duración con un rol, que funciona en tu propia máquina. Los empleados de Claude Code y Codex se ejecutan de forma nativa; otros agentes, como OpenCode, DeepSeek Harness y Gemini, se conectan mediante ACP (acpx). El trabajo avanza por un tablero de issues compartido, donde tú y los empleados asignáis issues, comentáis, os mencionáis con @ y cambiáis estados. Así es como un empleado de programación le pide un objeto nuevo a un empleado de Blender: lo menciona con @ en el issue. Los empleados se despiertan según un horario (heartbeats) y cada vez que los mencionan, así que el trabajo empieza sin que tengas que pasarlo tú.
No sustituye a Blender MCP; un empleado con el servidor instalado lo sigue usando. Añade los roles, el tablero y los despertares a su alrededor.
Preguntas frecuentes
¿Es gratis Blender MCP?
Sí. mcp-for-blender es de código abierto bajo MIT, y su sitio dice que todas las funciones están disponibles en el plan gratuito salvo la generación 3D, que requiere un plan Premium (desde 10 $ al mes) o tus propias claves de API de proveedor. El servidor de Blender Lab es gratuito bajo GPL-3.0.
¿Es seguro Blender MCP?
Ejecuta dentro de Blender cualquier Python que escriba el agente, y su servidor de socket no tiene autenticación. Guarda tu trabajo antes, lee los scripts antes de aprobarlos, mantenlo en localhost y establece BLENDER_MCP_SAFE_MODE=1 para bloquear el acceso a archivos, a otros programas y a la red. Establece DISABLE_TELEMETRY=true para desactivar la telemetría de uso.
¿Existe un servidor oficial de Blender MCP?
Sí. Blender Lab publica blender_mcp en projects.blender.org (GPL-3.0, Blender 5.1+), y aparece en el directorio de conectores de Claude como creado por Blender Lab. El popular mcp-for-blender es un proyecto de terceros sin afiliación con la Blender Foundation.
¿Cómo añado Blender MCP a Claude Code?
Instala uv, ejecuta claude mcp add blender uvx mcp-for-blender, compruébalo con claude mcp list y después instala y habilita el add-on de Blender con uvx mcp-for-blender install-addon. O ejecuta el instalador de un comando del README, que configura Claude Code por ti.
¿Cómo añado Blender MCP a Codex?
Ejecuta codex mcp add blender -- uvx mcp-for-blender, o añade a ~/.codex/config.toml una tabla [mcp_servers.blender] con command = "uvx" y args = ["mcp-for-blender"]. La CLI, la app de escritorio y la extensión para IDE comparten ese archivo. El README también ofrece un plugin de Codex con un viewport en vivo en el chat.
¿Debo usar Blender MCP o una skill de Blender?
Usa MCP cuando el agente deba actuar sobre una escena de Blender en ejecución; usa una skill cuando quieras darle un flujo de trabajo probado que seguir. Muchas configuraciones usan ambas: la skill describe el flujo de trabajo y el servidor MCP lo lleva a cabo.
Comandos y funciones verificados con el README de mcp-for-blender, el repositorio y el wiki de blender_mcp de Blender Lab, la documentación de MCP de Claude Code y Codex, y la documentación de exportación glTF de Blender el 21 de noviembre de 2026. No hemos ejecutado los comandos de instalación.