Sobre el proyecto

MCP for Blender es un complemento creado por la comunidad que conecta Blender 3D con cualquier LLM (como Claude, Codex o Cursor) a través del Protocolo de Contexto de Modelos (MCP). Permite crear, modificar y manipular escenas 3D usando instrucciones en lenguaje natural. ## Características principales - **Comunicación bidireccional**: conecta asistentes de IA a Blender mediante un servidor basado en sockets - **Manipulación de objetos**: crea, modifica y elimina objetos 3D - **Control de materiales**: aplica y modifica materiales y colores - **Ejecución de código**: ejecuta código arbitrario de Python en Blender desde la IA - **Generación de activos y modelos**: importa desde Poly Haven, Sketchfab, Poly Pizza y modelos generados por IA mediante Hyper3D Rodin y Hunyuan3D ## Cómo funciona El complemento consta de dos partes principales: 1. **Servidor MCP** (`src/blender_mcp/server.py`): un servidor Python que implementa el Protocolo de Contexto de Modelos 2. **Complemento de Blender**: un panel lateral en el viewport 3D de Blender que inicia la conexión ## Instalación 1. Instala `uv` (el gestor de paquetes de Python) usando el instalador oficial 2. Instala el complemento de Blender (ya sea por línea de comandos o manualmente a través de las preferencias de Blender) 3. Configura tu cliente MCP (Claude Desktop, Claude Code, Codex, Cursor, VS Code, etc.) 4. En Blender, presiona `N` para abrir el panel lateral, encuentra la pestaña **MCP para Blender** y haz clic en **Iniciar servidor MCP** ## Capacidades - Ejecuta cualquier código Python en Blender - Descarga modelos, activos y HDRIs desde Poly Haven - Busca y descarga modelos desde Sketchfab - Busca y descarga modelos de baja poligonización desde Poly Pizza - Genera modelos 3D mediante Hyper3D Rodin y Hunyuan3D (Tencent Cloud) ## Ejemplos de comandos - "Crea una escena de baja poligonización en una mazmorra, con un dragón custodiando un cofre de oro" - "Dame una imagen de referencia y crea una escena de Blender a partir de ella" - "Genera un modelo 3D de un gnomo de jardín a través de Hyper3D" - "Llena esta habitación con muebles de baja poligonización de Poly Pizza" ## Configuración Las variables de entorno permiten personalización: - `BLENDER_HOST` (predeterminado: `localhost`) - `BLENDER_PORT` (predeterminado: `9876`) - `BLENDER_MCP_SAFE_MODE`: establézcala en `1` para validar los scripts antes de ejecutarlos ## Consideraciones de seguridad - El servidor de sockets del complemento no tiene autenticación ni cifrado - Por defecto, la IA puede ejecutar cualquier código Python en Blender - El modo seguro (`BLENDER_MCP_SAFE_MODE=1`) bloquea operaciones de riesgo como E/S de archivos, acceso a redes o instalación persistente de código ## Credenciales API persistentes Guarda las claves API de Sketchfab, Poly Pizza, Hyper3D y Hunyuan3D en las preferencias de Blender o mediante variables de entorno para configuraciones sin interfaz o CI. ## Soporte para Docker El servidor MCP puede ejecutarse en un contenedor en lugar de instalarse localmente. Blender sigue ejecutándose en tu máquina; el contenedor solo aloja el servidor MCP y se conecta al complemento de Blender. ## Aviso legal Esta es una integración de terceros y no está hecha por Blender.