Blender MCP — Casos de uso, Instalar & Demo en vivo

Name: Blender MCP MCP Server
Author: ahujasid

Por qué usarlo

Características clave

Ejecución directa de bpy — todo lo que puedas escribir en script, Claude puede controlarlo
Introspección de escena: listar objetos, obtener propiedades, inspeccionar materiales
Integración con PolyHaven: buscar e importar HDRIs, texturas y modelos
Hyper3D rodin: generar modelos 3D con IA desde texto o imágenes
Búsqueda en Sketchfab integrada para explorar modelos gratuitos

Demo en vivo

Cómo se ve en la práctica

blender-mcp-ahujasid.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "blender-mcp-ahujasid": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "blender-mcp-ahujasid",
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "blender-mcp-ahujasid": {
      "command": {
        "path": "uvx",
        "args": [
          "blender-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add blender-mcp-ahujasid -- uvx blender-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Blender MCP

Construir una escena 3D desde un prompt de texto sin tocar la interfaz de Blender

👤 Diseñadores, desarrolladores indie y aficionados que no modelan con fluidez ⏱ ~30 min beginner

Cuándo usarlo: Quieres un boceto rápido de escena 3D pero no quieres aprender los atajos de Blender.

Requisitos previos

Blender 3.0+ instalado — Descárgalo desde blender.org
Addon de Blender MCP habilitado — Editar > Preferencias > Complementos > Instalar desde disco

Flujo

Conectar Claude a Blender

Abre Blender. En el panel N, haz clic en 'Connect to Claude'. Verifica la conexión en el chat listando los objetos de la escena.✓ Copiado

→ Escena vacía listada (Cube, Camera, Light) confirmando conexión en vivo
Componer la escena

Construye un claro de bosque low-poly: 5 árboles en círculo, una fogata en el centro, un saco de dormir cerca. Usa geometría simple.✓ Copiado

→ Los objetos aparecen en el viewport en tiempo real
Añadir atmósfera

Busca en PolyHaven un HDRI de atardecer. Aplícalo. Luego agrega un volumen de niebla pequeño sobre el suelo.✓ Copiado

→ La escena ahora tiene atmósfera iluminada; la niebla es visible en el render

Resultado: Una escena 3D de prototipo construida completamente mediante chat, lista para refinar.

Errores comunes

Blender se desconecta a mitad de sesión — Reconéctate desde el panel N; el addon escucha en un socket local

Generar assets 3D con Hyper3D rodin e importarlos directamente

👤 Desarrolladores de juegos y prototipadores que necesitan iteración rápida de assets ⏱ ~20 min intermediate

Cuándo usarlo: Necesitas un prop único y no quieres modelarlo desde cero ni pagar por assets del marketplace.

Requisitos previos

API key de Hyper3D rodin (nivel gratuito disponible) — Regístrate en hyper3d.ai; configura HYPER3D_RODIN_API_KEY

Flujo

Generar desde prompt

Genera un cofre del tesoro estilizado con bandas de hierro usando Hyper3D rodin. Impórtalo en el origen.✓ Copiado

→ El trabajo de generación se inicia; la malla se importa cuando termina (~30s)
Refinar y reimportar si es necesario

La malla es demasiado densa. Decímala a 5k triángulos y reimportala.✓ Copiado

→ La malla decimada reemplaza la original

Resultado: Prop 3D personalizado en la escena, generado y ajustado sin salir de Claude.

Errores comunes

La cola de generación está ocupada en el nivel gratuito — Reintenta con backoff exponencial o actualiza de nivel

Ejecutar operaciones en lote en muchos objetos mediante bpy

👤 TDs e ingenieros de pipeline ⏱ ~25 min advanced

Cuándo usarlo: Necesitas una acción masiva tediosa — renombrar jerarquía, reasignar materiales, desenvolver UV en lote.

Flujo

Describir la operación

Cada objeto que empiece con 'prop_' debe moverse a una colección 'Props' y tener su origen configurado en el centro de geometría.✓ Copiado

→ Claude escribe el snippet de bpy, pide confirmación antes de ejecutarlo
Ejecutar con red de seguridad

Muéstrame el script primero. Si parece seguro, ejecútalo. De lo contrario, revísalo.✓ Copiado

→ Script visible; ejecución aplicada; reporte de cuántos objetos se afectaron

Resultado: Operaciones masivas de escena realizadas en segundos con trazabilidad completa.

Errores comunes

Un script malo bloquea Blender — Guarda antes de cualquier ejecución de bpy; el addon no tiene sandbox

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

blender-mcp-ahujasid + filesystem

Guardar renders y exportaciones en disco

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
execute_blender_code	code: str	Cualquier operación directa de bpy	0
get_scene_info	()	Primera llamada para entender qué hay en la escena	0
get_object_info	name: str	Inspeccionar un objeto específico antes de editarlo	0
polyhaven_search_assets	asset_type: hdri\|model\|texture, categories?	Buscar assets PBR gratuitos	0
polyhaven_download_asset	asset_id, resolution	Obtener y aplicar HDRI/textura	0
generate_hyper3d_model_via_text	prompt: str	Generar un modelo 3D con IA	1 crédito de generación

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: PolyHaven: ilimitado y gratuito. Hyper3D: nivel gratuito ~20 generaciones/día
Tokens por llamada: 100–800 por llamada (el estado de escena puede ser extenso)
Monetario: Addon gratuito. Niveles de pago de Hyper3D desde $10/mes
Consejo: Usa Sketchfab y PolyHaven antes de pagar por generaciones de Hyper3D

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: blender-bpy-exec filesystem-write (for downloads)

Almacenamiento de credenciales: Clave de Hyper3D en variable de entorno

Salida de datos: CDN de PolyHaven, API de Hyper3D

execute_blender_code ejecuta Python arbitrario en tu Blender — revisa antes de correr scripts desconocidos

Resolución de problemas

Errores comunes y soluciones

Conexión rechazada

Asegúrate de que Blender esté abierto y el addon tenga 'Connect to Claude' activado; puerto por defecto 9876

Generación de Hyper3D colgada

Verifica la variable de entorno HYPER3D_RODIN_API_KEY; revisa la cuota de nivel en hyper3d.ai

Objeto no encontrado después de editar

El nombre del objeto puede tener un sufijo numérico (.001) — usa get_scene_info para refrescar

Alternativas

Blender MCP vs otros

Alternativa	Cuándo usarla	Contrapartida
Unity MCP / Unreal MCP	Tu pipeline es principalmente motor de juego, no DCC	Los MCPs de motor apuntan al runtime/escena; Blender MCP apunta a la autoría
Cesium MCP	Necesitas 3D geoespacial a escala mundial	Cesium es para escenas georreferenciadas; Blender es de forma libre

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills