BlenderMCP

Conecta Blender a Claude AI a través del Protocolo de Contexto de Modelo (MCP), permitiendo la interacción y control directo para modelado

Documentación

MCP para Blender

Conecta Blender a cualquier LLM

antes blender-mcp — el paquete de PyPI ahora es mcp-for-blender. Las configuraciones existentes siguen funcionando; no se requiere cambio de configuración. Leer más

Aviso: Esta es una integración de terceros y no está hecha por Blender

Modelado 3D asistido por prompts, creación de escenas y manipulación — impulsado por IA.

PyPI Downloads Discord Website Sponsor PyPI Version License: MIT

ahujasid%2Fblender-mcp | Trendshift


Patrocinadores

CodeRabbit Guillermo Rauch

Todos los patrocinadores: Apoya este proyecto


Inicio rápido

Nota: el paquete de PyPI blender-mcp ahora es mcp-for-blender. Las configuraciones existentes siguen funcionando — uvx blender-mcp aún ejecuta el servidor y no se requiere cambio de configuración. Las instalaciones nuevas deben usar mcp-for-blender. Qué cambió y por qué

Un solo comando configura tus aplicaciones de IA y el addon de Blender:

macOS / Linux

curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

¿Ya tienes uv? Ejecuta uvx mcp-for-blender setup en su lugar.

Instala uv si es necesario, encuentra los clientes MCP en tu máquina (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Devin Desktop/Windsurf, OpenCode, Antigravity) y te permite elegir cuáles configurar. Luego instala el addon de Blender y lo habilita. Tu configuración existente se conserva: solo agrega una entrada blender y guarda una .bak de cada archivo que modifica.

Luego cierra y vuelve a abrir completamente tu aplicación de IA (en Windows, ciérrala desde la bandeja del sistema), abre Blender y pídele que construya algo. El addon inicia su servidor cuando Blender se abre.

Configuración manual, en caso de que la configuración automática no funcione

Tres pasos: instala uv, apunta tu cliente MCP al servidor, instala el addon de Blender.

1. Instala uv

# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Advertencia: No continúes antes de instalar uv. Usa el instalador oficial — no pip install uv.

2. Agrega el servidor MCP a tu cliente

Claude Desktop — Configuración → Desarrollador → Editar configuración
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["mcp-for-blender"]
        }
    }
}
Claude Code
claude mcp add blender uvx mcp-for-blender
Codex
codex mcp add blender -- uvx mcp-for-blender
Cursor / VS Code / OpenCode / Antigravity

Consulta Configuración del cliente MCP a continuación para instrucciones por cliente y botones de instalación con un clic.

3. Instala el addon de Blender

uvx mcp-for-blender install-addon

Luego en Blender: Editar → Preferencias → Add-ons → habilita Interfaz: MCP para Blender.

4. Conecta

El addon inicia su servidor cuando Blender se abre. Para verificar, presiona N en la vista 3D → abre la pestaña MCP para Blender (haz clic en Iniciar servidor MCP si no está ejecutándose). Eso es todo — pídele a Claude que construya algo.

Nota: Ejecuta solo una instancia del servidor MCP (ya sea Cursor o Claude Desktop), no ambas.


Tabla de contenidos


Características

Comunicación bidireccionalConecta Claude AI a Blender a través de un servidor basado en sockets
Manipulación de objetosCrea, modifica y elimina objetos 3D en Blender
Control de materialesAplica y modifica materiales y colores
Verificación visualVistas de múltiples ángulos, cámara, wireframe, rayos X y tiras de animación, además de renders, para que la IA verifique su propio trabajo
Ejecución de códigoLa IA escribe Python de Blender directamente
Generación de assets y modelosAssets de Poly Haven, modelos de Sketchfab, modelos low-poly de Poly Pizza y modelos 3D generados por IA mediante Tripo, Hyper3D Rodin y Hunyuan3D

Premium

Genera modelos 3D con IA (Hunyuan3D, Tripo, Hyper3D Rodin) directamente en Blender sin necesidad de traer tus propias claves API. Más detalles

Componentes

El sistema consta de dos componentes principales:

  1. Addon de Blender (addon.py) — un addon de Blender que crea un servidor de sockets dentro de Blender para recibir y ejecutar comandos
  2. Servidor MCP (src/blender_mcp/server.py) — un servidor Python que implementa el Protocolo de Contexto de Modelos y se conecta al addon de Blender

Instalación

Configuración automática

La forma más rápida es el instalador de una línea. Instala uv, configura tus clientes MCP e instala y habilita el addon de Blender:

# macOS / Linux
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

¿Ya tienes uv? Ejecuta uvx mcp-for-blender setup en su lugar. Consulta Inicio rápido para ver qué cambia. El resto de esta sección cubre la configuración manual.

Requisitos previos

  • Blender 3.0 o más reciente
  • Python 3.10 o más reciente
  • uv gestor de paquetes
Instalación de uv, por plataforma

macOS

brew install uv

Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Luego agrega uv a la ruta de usuario en Windows (puede que necesites reiniciar Claude Desktop después):

$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Se instala en ~/.local/bin — abre una nueva terminal para que esté en tu PATH.

De lo contrario, las instrucciones de instalación están en su sitio web: Instalar uv

En todos los sistemas operativos, usa el instalador oficial de uv anterior — no pip install uv, que puede no crear el comando uvx y puede ocultar uv dentro de un entorno que tu cliente no puede ver.

Advertencia: No continúes antes de instalar uv.

Haz que tu cliente encuentre uvx

Los clientes MCP iniciados desde una GUI (Claude Desktop, Cursor, VS Code desde el Dock/menú Inicio) no heredan el PATH de tu terminal, por lo que un "command": "uvx" simple puede fallar con spawn uvx ENOENT aunque uvx funcione en tu terminal. Si eso ocurre:

  • Encuentra la ruta completa de uvx — which uvx (macOS/Linux) o where uvx (Windows) — y úsala como "command", por ejemplo /opt/homebrew/bin/uvx o C:\Users\<you>\.local\bin\uvx.exe.
  • En Windows puedes envolverlo en su lugar: "command": "cmd", "args": ["/c", "uvx", "mcp-for-blender"].
  • Después de cualquier cambio de PATH o configuración, cierra y relanza completamente el cliente (Windows: sal desde la bandeja del sistema, no solo la ventana; macOS: Cmd+Q).

Fija la versión de Python

Evita conflictos de conda / pyenv / versiones.

uv elige qué Python ejecuta el servidor. En máquinas con conda (base autoactivada), pyenv o asdf — o con una versión más reciente de CPython para la que algunas dependencias aún no tienen wheels — uv puede tomar un intérprete que haga fallar la instalación. Fija Python 3.11 y prefiere intérpretes gestionados por uv para evitar usar lo que esté en tu PATH:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["--python", "3.11", "mcp-for-blender"],
            "env": { "UV_PYTHON_PREFERENCE": "only-managed" }
        }
    }
}

--python 3.11 aún satisface el requires-python >=3.10 de este paquete, y UV_PYTHON_PREFERENCE=only-managed evita que uv seleccione conda, pyenv, asdf o el Python del sistema primero. (El .python-version del repositorio es solo una pista para colaboradores y no afecta a uvx).

Si un intento fallido anterior se sigue reproduciendo después de una corrección, limpia la caché:

uv cache clean mcp-for-blender blender-mcp && uvx --refresh mcp-for-blender

Instalar sin uv

En máquinas restringidas puedes omitir uvx por completo con pipx, y luego apuntar tu cliente al comando instalado:

pipx install mcp-for-blender
pipx ensurepath          # then restart your shell / client

Usa la ruta absoluta resultante como "command" (encuéntrala con which mcp-for-blender / where mcp-for-blender) y omite args.

Ejecutar con Docker

Puedes ejecutar el servidor MCP en un contenedor en lugar de instalarlo. Blender en sí sigue ejecutándose en tu máquina — el contenedor solo aloja el servidor MCP, que se conecta hacia afuera al addon de Blender.

Construye la imagen desde la raíz del repositorio:

docker build -t mcp-for-blender .

Luego apunta tu cliente MCP a ella (la bandera -i es obligatoria — el servidor habla con el cliente a través de stdin/stdout):

{
    "mcpServers": {
        "blender": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "mcp-for-blender"]
        }
    }
}

La imagen usa por defecto BLENDER_HOST=host.docker.internal, que llega al Blender del host sin configuración adicional con Docker Desktop en macOS y Windows.

En Linux, host.docker.internal no existe y el addon solo escucha en localhost, así que usa redes de host en su lugar:

{
    "mcpServers": {
        "blender": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "--network=host", "-e", "BLENDER_HOST=localhost", "mcp-for-blender"]
        }
    }
}

Para habilitar el modo seguro en el contenedor, agrega "-e", "BLENDER_MCP_SAFE_MODE=1" a args.

Variables de entorno

Las siguientes variables de entorno se pueden usar para configurar la conexión de Blender:

VariablePredeterminadoDescripción
BLENDER_HOSTlocalhostDirección del host para el servidor de sockets de Blender
BLENDER_PORT9876Número de puerto para el servidor de sockets de Blender
BLENDER_MCP_SAFE_MODEoffEstablece en 1 para validar scripts antes de que se ejecuten en Blender (ver más abajo)
BLENDER_MCP_APPSautoEstablece en 1 para forzar la aplicación de viewport en línea para clientes que admiten MCP Apps sin anunciarlo (el plugin de Codex establece esto)
BLENDER_MCP_OPENAI_FORMSautoEstablece en 1 para forzar los selectores de assets con miniaturas (el plugin de Codex establece esto)

Ejemplo:

export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876

También puedes pasar la conexión como banderas de CLI, que tienen prioridad sobre las variables de entorno. Esto es útil para ejecutar varias instancias de Blender lado a lado, ya que cada entrada de cliente MCP puede apuntar a un puerto diferente con argumentos simples en lugar de variables de entorno:

uvx mcp-for-blender --port 9877

En una configuración de cliente MCP, eso significa una segunda entrada que difiere solo en args:

{
  "mcpServers": {
    "blender": { "command": "uvx", "args": ["mcp-for-blender"] },
    "blender-b": { "command": "uvx", "args": ["mcp-for-blender", "--port", "9877"] }
  }
}

Cada instancia necesita su propio puerto configurado en el panel del addon de Blender para que coincida.

Nota: el servidor de sockets del addon no tiene autenticación ni cifrado, por lo que cualquiera que pueda alcanzar ese puerto puede ejecutar Python dentro de Blender. Mantenlo en localhost a menos que estés en una red confiable, y prefiere un túnel SSH en lugar de apuntar --host/BLENDER_HOST a una máquina remota directamente.

Modo seguro

Por defecto, la IA puede ejecutar cualquier código Python en Blender. Configura BLENDER_MCP_SAFE_MODE=1 para revisar cada script antes de que se ejecute y bloquear código riesgoso — cosas como leer o escribir archivos directamente, ejecutar otros programas, acceder a la red o instalar código que sigue ejecutándose después de que el script termina. El trabajo normal de Blender (modelado, materiales, renderizado, guardado, importación/exportación) sigue funcionando. Los scripts bloqueados se devuelven a la IA con el motivo, para que pueda intentarlo de nuevo con una versión corregida.


Configuración del Cliente MCP

Claude for Desktop

Ver el video de instrucciones de configuración (asumiendo que ya has instalado uv)

Ve a Claude → Configuración → Desarrollador → Editar configuración → claude_desktop_config.json e incluye lo siguiente:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "mcp-for-blender"
            ]
        }
    }
}
Claude Code

Usa la CLI de Claude Code para añadir el MCP para el servidor de Blender:

claude mcp add blender uvx mcp-for-blender

Codex

La CLI de Codex, la aplicación de escritorio y la extensión de IDE comparten el mismo archivo de configuración (~/.codex/config.toml), por lo que configurar el servidor una vez cubre los tres.

Plugin de Codex (recomendado)

El plugin añade una vista en vivo en línea dentro del chat (haz clic en un objeto para adjuntarlo a tu siguiente mensaje), selectores de miniaturas para Poly Haven, Sketchfab y Poly Pizza, y menciones con @ para objetos de escena, materiales y colecciones. Aún no está en el directorio de plugins de Codex, así que añádelo desde este repositorio:

git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex

Luego reinicia Codex, instala MCP for Blender desde el directorio de plugins y pídele que use MCP for Blender en el chat. Una vez que esté en ejecución, la vista se abre en un panel lateral junto a la conversación:

MCP for Blender plugin in the Codex app, showing the live viewport beside the chat

Servidor MCP simple

Registra el servidor con la CLI de Codex:

codex mcp add blender -- uvx mcp-for-blender

O añádelo manualmente a ~/.codex/config.toml (o $CODEX_HOME/config.toml):

[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]

O en la aplicación de escritorio de Codex: Configuración → Servidores MCP → Añadir servidor → nómbralo blender, elige STDIO, introduce uvx mcp-for-blender como comando, luego Guardar y reinicia. Si la aplicación no encuentra uvx, usa su ruta completa en su lugar — consulta Haz que tu cliente encuentre uvx.

Verifica que se haya registrado con codex mcp list — el servidor blender debería mostrarse como habilitado. Las herramientas estarán disponibles la próxima vez que inicies Codex.

Para configurar variables de entorno (por ejemplo, un host/puerto de Blender no predeterminado), pasa banderas --env KEY=VALUE a codex mcp add, o añádelas en el archivo de configuración:

[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
env = { BLENDER_HOST = "localhost", BLENDER_PORT = "9876" }

Cursor

Install MCP Server

macOS — ve a Configuración → MCP y pega lo siguiente:

  • Para usarlo como servidor global, usa el botón "añadir nuevo servidor MCP global" y pega
  • Para usarlo como servidor específico del proyecto, crea .cursor/mcp.json en la raíz del proyecto y pega
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "mcp-for-blender"
            ]
        }
    }
}

Windows — ve a Configuración → MCP → Añadir servidor, añade un nuevo servidor con la siguiente configuración:

{
    "mcpServers": {
        "blender": {
            "command": "cmd",
            "args": [
                "/c",
                "uvx",
                "mcp-for-blender"
            ]
        }
    }
}

Video de configuración de Cursor

Nota: Ejecuta solo una instancia del servidor MCP (ya sea en Cursor o Claude Desktop), no ambas.

Visual Studio Code

Requisitos previos: Asegúrate de tener Visual Studio Code instalado antes de continuar.

Install in VS Code

OpenCode

{
  "mcp": {
    "blender-mcp": {
      "type": "local",
      "command": ["uvx", "mcp-for-blender"],
      "enabled": true,
      "environment": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

Antigravity

{
  "mcpServers": {
    "blender-mcp": {
      "command": "uvx",
      "args": ["mcp-for-blender"],
      "env": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

Instalación del Addon de Blender

uvx mcp-for-blender setup (consulta Inicio rápido) hace todo esto, incluida la habilitación del addon. Los pasos a continuación son para hacerlo manualmente.

1. Recomendado — desde una terminal, ejecuta:

uvx mcp-for-blender install-addon

Esto copia el addon en tu carpeta de addons de Blender como blender_mcp.py. Imprime dónde lo escribió y guarda una .bak de cualquier archivo que reemplace.

Opcional: uvx mcp-for-blender addon-paths lista las carpetas de addons de Blender detectadas. Anula el destino con BLENDERMCP_ADDONS_DIR=/path/to/scripts/addons.

2. Abre Blender

3. Ve a Editar → Preferencias → Add-ons

4. Habilita Interfaz: MCP for Blender (busca "MCP for Blender"). Si aún no aparece, haz clic en Instalar… y selecciona el blender_mcp.py / addon.py copiado, o reinicia Blender.

5. Alternativa manual — si el comando anterior no puede encontrar tu instalación de Blender, o prefieres hacerlo a mano: descarga addon.py de este repositorio → en Blender, Editar → Preferencias → Add-ons → Instalar… → selecciona el addon.py descargado → habilítalo.

Luego abre la pestaña MCP for Blender en la barra lateral de Blender (presiona N en la vista 3D) y haz clic en Iniciar servidor MCP. Consulta Iniciando la conexión a continuación.

Actualización (usuarios existentes)

Para nuevos usuarios, ve directamente a Inicio rápido. Para usuarios existentes, consulta a continuación.

1. Ejecuta:

uvx mcp-for-blender@latest update

Esto actualiza el servidor MCP (refrescando la copia en caché de uv, o actualizando un uv tool install) y cada copia instalada del addon de Blender, guardando una .bak de cada archivo que reemplaza. Nunca degrada un addon más nuevo que la versión publicada y deja intacta una copia que hayas editado localmente. Añade --dry-run para ver qué cambiaría primero.

Usa @latest la primera vez: las versiones anteriores a 2.1.7 no tienen el comando update, y uvx puede tener una de esas en caché.

2. Reinicia tu cliente MCP (Claude Desktop, Cursor, ...) para que inicie el nuevo servidor.

3. En Blender: reinícialo, o Preferencias → Add-ons → deshabilita y vuelve a habilitar Interfaz: MCP for Blender, luego haz clic en Iniciar servidor MCP nuevamente.

Si un cliente aún está configurado con el antiguo nombre de paquete blender-mcp, update lo indica; uvx mcp-for-blender setup lo cambia.

Nota: el servidor MCP nunca modifica tus archivos de addon de Blender por sí solo. Cuando se inicia, verifica si el addon instalado está desactualizado en comparación con la copia incluida y registra cómo actualizar; update y install-addon son los que realmente escriben. La captura de trayectoria aún funciona en addons cargados más antiguos mediante un respaldo de execute_code.


Uso

Iniciando la conexión

MCP for Blender in the sidebar

  1. En Blender, ve a la barra lateral de la vista 3D (presiona N si no está visible)
  2. Encuentra la pestaña MCP for Blender
  3. Activa las casillas que desees usar (consulta más en Capacidades a continuación)
  4. Haz clic en Conectar con Claude
  5. Asegúrate de que el servidor MCP esté ejecutándose en tu terminal

Uso con Claude

Una vez que el archivo de configuración se haya establecido en Claude y el addon se esté ejecutando en Blender, verás un ícono de martillo con herramientas para MCP for Blender.

MCP for Blender in the sidebar

Capacidades

La IA escribe Python de Blender por sí misma para modelado, diseño, materiales, animación, rigging y retopología. El MCP añade lo que Python no puede hacer por sí solo, como nueve herramientas:

HerramientaPara qué sirve
execute_blender_codeEjecuta Python en tu Blender en vivo
lookVe el resultado desde viewport, camera, angles (hoja de vista múltiple con encuadre automático, cualquier dirección) o frames (tira de animación), dibujado solid, material, rendered, wireframe o xray; o muestra un render o archivo de imagen
get_scene_infoResumen compacto de escena, una línea por objeto con los campos que elijas (ubicación, materiales, topología, pesos, ...); profundiza con root o query
generate_3dUna llamada para generar e importar un modelo con Tripo, Hunyuan3D o Hyper3D Rodin. Los generadores premium se prefieren automáticamente
search_assets / import_assetPoly Haven HDRIs, texturas y modelos, Sketchfab modelos, Poly Pizza modelos low-poly
get_addon_statusVersión de Blender, versión del addon y qué bibliotecas y generadores están activados
disable_telemetry, record_trajectory_feedbackControles de recopilación de datos

Hunyuan3D en Tencent Cloud (modo API oficial)

Qué servicio de Tencent Cloud debe llamar el addon depende de dónde viva tu cuenta:

CuentaServicio que llama el addonRegiónAlternancia en la barra lateral
Continental (cloud.tencent.com)AI3D 3.0 (ai3d, versión 2025-05-13)ap-guangzhoudeja Cuenta internacional (Pro) desactivada (predeterminado)
Internacional (tencentcloud.com), Hunyuan-to-3D (Profesional)hunyuan, versión 2023-09-01, PBR habilitadoap-singaporemarca Cuenta internacional (Pro)

Las credenciales internacionales enviadas al endpoint continental fallan con AuthFailure.SignatureFailure o ResourceUnavailable, así que marca la alternancia cuando tus SecretId/SecretKey provengan de tencentcloud.com. La alternancia se encuentra bajo Tencent Hunyuan 3D → API oficial en la barra lateral.

Poly Haven

Poly Haven publica alrededor de 2,400 HDRIs, texturas y modelos, todos CC0 y gratuitos, financiados por donaciones en lugar de vender los activos. No hay clave de API, ni cuenta ni límite de velocidad que valga la pena preocuparse.

En la barra lateral de la vista 3D, marca Poly Haven. Esa es toda la configuración.

Ejemplo práctico:

"Ilumina la escena con un HDRI de tarde nublada y pon una textura de metal oxidado en la pared"

Claude llama a search_assets(source="polyhaven", query="overcast afternoon", asset_type="hdris"), que entiende la intención en lugar de coincidir palabras clave — "sofá" encuentra sofás, y funciona en cualquier idioma. previews=3 adjunta miniaturas de los mejores resultados antes de gastar el ancho de banda, y import_asset(source="polyhaven", id="...", asset_type="textures", apply_to=["Wall"]) descarga una textura y la aplica en una sola llamada.

Las búsquedas también pueden filtrar por ruta de categoría o por atributos como clima y hora del día para HDRIs, o uso de superficie y condición para texturas; un atributo desconocido genera un error con los válidos.

Los modelos se importan desde el .blend, que es el archivo que el artista creó — las versiones glTF, FBX y USD se generan a partir de él y pierden detalle de material. Las texturas construyen un material Principled a partir de los mapas que lo impulsan y omiten los reempaquetados y convenciones alternativas que nada lee. Los HDRIs se empaquetan en el archivo, por lo que la iluminación sobrevive al guardado y reapertura en otro lugar, y llegan en un mundo nuevo en lugar de sobrescribir uno que hayas construido.

Licencia y atribución: cada activo de Poly Haven es CC0. Nunca tienes que acreditar a nadie, por nada, comercial o no. Sus términos de API sí piden que el software construido sobre la API en vivo deje claro de dónde provienen los activos, por lo que las respuestas de búsqueda e importación nombran la fuente y enlazan la página del activo. Al importar, polyhaven_id, polyhaven_url, polyhaven_authors, polyhaven_resolution y polyhaven_licence se escriben en los objetos, materiales, imágenes y mundo importados como propiedades personalizadas, para que quien abra el .blend más tarde aún pueda encontrar el activo y al artista que lo creó.

Poly Pizza

Poly Pizza aloja aproximadamente 10,600 modelos low-poly gratuitos, incluido el archivo rescatado de Google Poly. Es la mejor fuente para activos de juegos estilizados: cada modelo es un único .glb autocontenido, y la geometría es mucho más ligera que la de Sketchfab.

  1. Obtén una clave de API gratuita en poly.pizza/settings/api
  2. En la barra lateral de la vista 3D, marca Usar activos de Poly Pizza
  3. Pega la clave en el campo Clave de API que aparece (o guárdala permanentemente en Editar → Preferencias → Add-ons → MCP for Blender)

Ejemplo práctico:

"Busca en Poly Pizza una silla low-poly bajo licencia CC0 e importa una a 1 metro de altura"

Claude llama a search_assets(source="polypizza", query="chair", licence="CC0"), que devuelve cada coincidencia con su licencia y recuento de triángulos, luego import_asset(source="polypizza", id="...", target_size=1.0).

También puedes filtrar por categoría ("Animals", "Furniture & Decor", "Transport", "Nature", "Buildings", "People & Characters", "Food & Drink", "Weapons", "Clutter", "Objects", "Scenes & Levels", "Other") o pedir solo modelos animados. Atribución: aproximadamente el 69% del catálogo de Poly Pizza es CC-BY, lo que requiere que acredites al creador dondequiera que aparezca el modelo. Al importar, la línea de crédito con formato listo se escribe en cada objeto raíz importado como la propiedad personalizada polypizza_attribution (junto con polypizza_id y polypizza_licence), por lo que se guarda en tu .blend y sobrevive a la sesión. Filtra con licence="CC0" si prefieres usar modelos que no requieran crédito.

Comandos de Ejemplo

Aquí hay algunos ejemplos de lo que puedes pedirle a Claude que haga:

PromptDemo
"Crea una escena low poly en una mazmorra, con un dragón custodiando una olla de oro"Ver
"Crea un ambiente playero usando HDRIs, texturas y modelos como rocas y vegetación de Poly Haven"Ver
Da una imagen de referencia y crea una escena de Blender a partir de ellaVer
"Obtén información sobre la escena actual y haz un boceto threejs a partir de ella"Ver
"Genera un modelo 3D de un gnomo de jardín a través de Hyper3D"
"Llena esta habitación con muebles low-poly de Poly Pizza"
"Haz este coche rojo y metálico"
"Crea una esfera y colócala encima del cubo"
"Haz la iluminación como la de un estudio"
"Apunta la cámara a la escena y hazla isométrica"

Credenciales API Persistentes

MCP para Blender admite credenciales persistentes a través de las Preferencias del Add-on de Blender:

Editar → Preferencias → Add-ons → MCP para Blender

Puedes almacenar estos valores allí para que sobrevivan a los reinicios de Blender:

  • Clave API de Sketchfab
  • Clave API de Poly Pizza
  • Clave API de Hyper3D
  • SecretId / SecretKey de Hunyuan3D
  • URL de API de Hunyuan3D

Para configuraciones headless o CI, las credenciales también se pueden inyectar mediante variables de entorno:

Variable
BLENDERMCP_SKETCHFAB_API_KEY
BLENDERMCP_POLYPIZZA_API_KEY
BLENDERMCP_HYPER3D_API_KEY
BLENDERMCP_HUNYUAN3D_SECRET_ID
BLENDERMCP_HUNYUAN3D_SECRET_KEY
BLENDERMCP_HUNYUAN3D_API_URL

Solución de Problemas

ProblemaSolución
Problemas de conexiónAsegúrate de que el servidor del addon de Blender esté ejecutándose y que el servidor MCP esté configurado en Claude. No ejecutes el comando uvx en la terminal. A veces el primer comando no pasa, pero después empieza a funcionar.
Errores de tiempo de esperaIntenta simplificar tus solicitudes o dividirlas en pasos más pequeños.
Blender se congela durante una descarga de Poly HavenLos activos se descargan en el hilo principal de Blender, por lo que la interfaz deja de responder hasta que finaliza la transferencia. El tamaño del archivo crece aproximadamente cuatro veces por paso de resolución, así que pide 1k o 2k a menos que el activo esté cerca de la cámara.
La descarga de Poly Pizza falla con un desafío de Cloudflarestatic.poly.pizza está detrás de la protección contra bots y bloquea IPs de centros de datos, VPN y nube. Tu clave API está bien: la CDN nunca la ve. Reintenta desde una conexión normal, o descarga el .glb manualmente y usa Archivo → Importar → glTF 2.0.
¿Has probado a apagarlo y encenderlo?Si aún tienes errores de conexión, intenta reiniciar tanto Claude como el servidor de Blender.

Detalles Técnicos

Protocolo de Comunicación

El sistema usa un protocolo simple basado en JSON sobre sockets TCP:

  • Comandos se envían como objetos JSON con un type y un params opcional
  • Respuestas son objetos JSON con un status y result o message

Limitaciones y Consideraciones de Seguridad

Advertencia: La herramienta execute_blender_code permite ejecutar código Python arbitrario en Blender, lo que puede ser potente pero potencialmente peligroso. Úsala con precaución en entornos de producción. SIEMPRE guarda tu trabajo antes de usarla.

  • Poly Haven requiere descargar modelos, texturas e imágenes HDRI. Si no quieres usarlo, desactívalo en la casilla de verificación en Blender.
  • Las operaciones complejas podrían necesitar dividirse en pasos más pequeños.

Control de Telemetría

La telemetría es opt-in. La recopilación de tu contenido está desactivada por defecto y permanece así hasta que la actives explícitamente.

Qué se recopila por defecto (sin opt-in): un registro de uso anónimo mínimo para que pueda contar usuarios activos y ver qué herramientas se usan — un ID de instalación generado aleatoriamente, un ID de sesión, el nombre de la herramienta, si tuvo éxito, cuánto tardó, las versiones de MCP para Blender y Blender, tu sistema operativo y una marca de tiempo.

Nunca se recopila sin opt-in: tus prompts, código generado, capturas de pantalla del viewport, datos de escena y pasos de trayectoria.

Para optar — ve a Editar → Preferencias → Add-ons → MCP para Blender y marca la casilla de consentimiento de telemetría. Algunos clientes MCP también te ofrecerán un aviso de opt-in único al inicio de una conversación. Optar agrega prompts, código generado, capturas de pantalla y datos de trayectoria a lo recopilado; consulta los TnC para más detalles. Puedes desactivarlo nuevamente en el mismo lugar en cualquier momento.

Para desactivar la telemetría por completo, incluido el registro de uso anónimo mínimo, establece una variable de entorno:

DISABLE_TELEMETRY=true uvx mcp-for-blender

O agrégalo a tu configuración MCP:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["mcp-for-blender"],
            "env": {
                "DISABLE_TELEMETRY": "true"
            }
        }
    }
}

Los datos de telemetría no están vinculados a tu nombre o cuenta. Pueden usarse para mejorar MCP para Blender, para investigación y para entrenar modelos de IA.

El detalle completo de lo que se recopila y la licencia que otorgas al optar está en TERMS_AND_CONDITIONS.md.


Comentarios

Buscamos activamente comentarios sobre MCP para Blender. Si tienes opiniones, compártelas aquí.

Si tienes comentarios más detallados, puedes programar una llamada con nosotros aquí — te acreditaremos en el proyecto.

Únete a la Comunidad

Da comentarios, inspírate y construye sobre el MCP: Discord

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Aviso Legal

Esta es una integración de terceros y no está hecha por Blender. Hecha por Siddharth.


Historial de Estrellas

Star History Chart

Si MCP para Blender te resulta útil, considera darle una estrella al repositorio