BlenderMCP

Conecta Blender con modelos de IA a través de MCP para modelado 3D, creación de escenas y manipulación asistida por indicaciones.

GitHub
11
Prueba este MCPPatrocinado

Documentación

BlenderMCP - Integración del Protocolo de Contexto de Modelo de Blender

smithery badge Blender-mcp

para ver el video de demostración, haz clic aquí

BlenderMCP conecta Blender con Claude AI y cursor a través del Protocolo de Contexto de Modelo (MCP), permitiendo que Claude y cursor interactúen directamente y controlen Blender. Esta integración permite el modelado 3D asistido por indicaciones, la creación de escenas y la manipulación.

Notas de la versión (1.1.0)

  • Se agregó soporte para activos de Poly Haven a través de su API
  • Se agregó soporte para generar modelos 3D mediante indicaciones usando Hyper3D Rodin
  • Para los nuevos usuarios, puedes ir directamente a Instalación. Para los usuarios existentes, consulta los puntos a continuación
  • Descarga el archivo addon.py más reciente y reemplaza el anterior, luego agrégalo a Blender
  • Elimina el servidor MCP de Claude y vuelve a agregarlo, ¡y deberías estar listo!

Características

  • Comunicación bidireccional: Conecta Claude AI a Blender a través de un servidor basado en sockets
  • Manipulación de objetos: Crea, modifica y elimina objetos 3D en Blender
  • Control de materiales: Aplica y modifica materiales y colores
  • Inspección de escenas: Obtén información detallada sobre la escena actual de Blender
  • Ejecución de código: Ejecuta código Python arbitrario en Blender desde Claude

Componentes

El sistema consta de dos componentes principales:

  1. Complemento de Blender (addon.py): Un complemento 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 Modelo y se conecta al complemento de Blender

Instalación

Requisitos previos

  • Blender 3.0 o más reciente
  • Python 3.10 o más reciente
  • Administrador de paquetes uv:

Si estás en Mac, instala uv como

brew install uv

En Windows

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

y luego

set Path=C:\Users\nntra\.local\bin;%Path%

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

⚠️ No continúes antes de instalar UV

Instalación a través de Smithery

Para instalar el Servidor de Integración de Blender para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @Gorav22/blender-mcp --client claude

Integración con Claude para Desktop

Ve a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json para incluir lo siguiente:

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

Integración con Cursor

Para usuarios de Mac, ve a Configuración > MCP y pega lo siguiente

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

Para usuarios de Windows, ve a Configuración > MCP > Agregar servidor, agrega un nuevo servidor con la siguiente configuración:

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

⚠️ Ejecuta solo una instancia del servidor MCP (ya sea en Cursor o Claude Desktop), no ambas

Instalación del complemento de Blender

  1. Descarga el archivo addon.py de este repositorio
  2. Abre Blender
  3. Ve a Editar > Preferencias > Complementos
  4. Haz clic en "Instalar..." y selecciona el archivo addon.py
  5. Habilita el complemento marcando la casilla junto a "Interfaz: Blender MCP"

Uso

Iniciar la conexión

  1. En Blender, ve a la barra lateral de la vista 3D (presiona N si no está visible)
  2. Encuentra la pestaña "BlenderMCP"
  3. Activa la casilla de Poly Haven si deseas activos de su API (opcional)
  4. Haz clic en "Conectar a 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 complemento esté ejecutándose en Blender, verás un ícono de martillo con herramientas para el Blender MCP.

Capacidades

  • Obtener información de escenas y objetos
  • Crear, eliminar y modificar formas
  • Aplicar o crear materiales para objetos
  • Ejecutar cualquier código Python en Blender
  • Descargar los modelos, activos y HDRIs correctos a través de Poly Haven
  • Modelos 3D generados por IA a través de Hyper3D Rodin

Integración con Hyper3D

La clave de prueba gratuita de Hyper3D te permite generar un número limitado de modelos por día. Si se alcanza el límite diario, puedes esperar al reinicio del día siguiente u obtener tu propia clave en hyper3d.ai y fal.ai.

Solución de problemas

  • Problemas de conexión: Asegúrate de que el servidor del complemento 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 se procesa, pero después comienza a funcionar.
  • Errores de tiempo de espera: Intenta simplificar tus solicitudes o dividirlas en pasos más pequeños
  • Integración con Poly Haven: Claude a veces es errático en su comportamiento
  • ¿Has intentado 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 utiliza 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

  • 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. GUARDA SIEMPRE tu trabajo antes de usarla.
  • Poly Haven requiere descargar modelos, texturas e imágenes HDRI. Si no deseas usarlo, desactívalo en la casilla en Blender.
  • Las operaciones complejas podrían necesitar dividirse en pasos más pequeños

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción.

Aviso legal

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