Servidor MCP para Blender

Servidor del Protocolo de Contexto de Modelo (MCP) para un control total de Blender mediante API

Este complemento transforma Blender en un servidor MCP, exponiendo más de 50 potentes herramientas que pueden ser orquestadas por agentes de IA a través de endpoints HTTP. Perfecto para flujos de trabajo 3D impulsados por IA, automatización y experimentación creativa.

✨ Características

• 🚀 Más de 50 herramientas - Control total sobre las funciones de Blender:

  • Creación, manipulación y transformación de objetos

  • Gestión del sistema de materiales y sombreadores

  • Control de animaciones y fotogramas clave

  • Configuración de cámaras e iluminación

  • Modificadores y restricciones

  • Simulaciones físicas (cuerpo rígido, tela, fluidos)

  • Nodos de geometría y generación procedimental

  • Operaciones de importación/exportación de archivos

  • Optimización de escenas y operaciones por lotes

• 🔒 Ejecución segura para hilos - Sistema de colas de nivel empresarial para operaciones concurrentes seguras

• 📦 Instalación automática de dependencias - Instala automáticamente los paquetes necesarios en la primera ejecución

• 🎮 Panel de interfaz de usuario sencillo - Inicia/detiene el servidor con un clic desde el panel N de Blender

• 📊 Monitoreo en tiempo real - Rastrea operaciones, estadísticas y el estado del servidor

• 🔧 Listo para producción - Manejo integral de errores, registro y almacenamiento en caché

🚀 Inicio rápido

Instalación

1. Descarga blender_mcp.py

2. Abre Blender

3. Ve a Edit → Preferences → Add-ons

4. Haz clic en la flecha desplegable (⌄) junto a la barra de búsqueda

5. Selecciona Install from Disk...

6. Elige el archivo blender_mcp.py descargado

7. Habilita el complemento marcando la casilla junto a "MCP Complete Server for Blender"

Iniciar el servidor

1. Presiona N en la vista 3D para abrir la barra lateral

2. Navega a la pestaña MCP Server

3. Haz clic en Start Server

4. El servidor se iniciará en http://localhost:8000

El complemento instalará automáticamente las dependencias necesarias en la primera ejecución (FastAPI, Uvicorn, Pydantic, etc.).

🤖 Uso con PolyMCP

Este servidor MCP está diseñado para funcionar a la perfección con PolyMCP, un potente marco de trabajo para orquestar servidores MCP con agentes de IA.

Ejemplo: Blender controlado por IA

#!/usr/bin/env python3
import asyncio
from polymcp.polyagent import UnifiedPolyAgent, OllamaProvider

async def main():
    # Initialize your LLM provider
    llm = OllamaProvider(model="gpt-oss:120b-cloud", temperature=0.1)
    
    # Connect to Blender MCP server
    agent = UnifiedPolyAgent(
        llm_provider=llm, 
        mcp_servers=["http://localhost:8000/mcp"],  
        verbose=True
    )
    
    async with agent:
        print("✅ Blender MCP Server connected!\n")
        
        # Chat with your AI to control Blender
        while True:
            user_input = input("\n🎨 You: ")
            
            if user_input.lower() in ['exit', 'quit']:
                break
            
            result = await agent.run_async(user_input, max_steps=5)
            print(f"\n🤖 Blender: {result}")

if __name__ == "__main__":
    asyncio.run(main())

Comandos de ejemplo

Una vez conectado, puedes pedirle al agente de IA que:

• "Crea un cubo en la posición (0, 0, 0) con tamaño 2"

• "Añade un material metálico rojo al objeto seleccionado"

• "Crea una cámara mirando al origen"

• "Configura una escena de iluminación simple con 3 luces"

• "Añade una simulación de fluidos al cubo"

• "Exporta la escena como un archivo FBX"

• "Crea una animación rotando el objeto 360 grados a lo largo de 100 fotogramas"

¡Eso es todo! PolyMCP maneja toda la complejidad de:

• Descubrimiento y selección de herramientas

• Planificación de tareas en varios pasos

• Manejo de errores y reintentos

• Gestión de estado a través de operaciones

¡Esto hace que sea increíblemente sencillo construir herramientas de automatización para Blender impulsadas por IA!

📡 Endpoints de la API

Una vez que el servidor esté en funcionamiento, puedes acceder a:

• Documentación de la API: http://localhost:8000/docs

• Listar todas las herramientas: http://localhost:8000/mcp/list_tools

• Invocar herramienta: POST http://localhost:8000/mcp/invoke/{tool_name}

🛠️ Categorías de herramientas disponibles

• Operaciones de objetos: Crear, eliminar, duplicar, seleccionar objetos

• Transformaciones: Mover, rotar, escalar, aplicar transformaciones

• Materiales y sombreado: Crear materiales, añadir texturas, configurar nodos de sombreado

• Modelado: Añadir modificadores, operaciones booleanas, edición de malla

• Animación: Fotogramas clave, control de línea de tiempo, editor NLA

• Cámara e iluminación: Configuración de cámara, creación de luces, entornos HDRI

• Renderizado: Ajustes de renderizado, configuración de salida, renderizado

• Física: Cuerpo rígido, tela, simulaciones de fluidos

• Nodos de geometría: Generación procedimental, creación de árboles de nodos

• Operaciones de archivo: Importar/exportar varios formatos (FBX, OBJ, USD, etc.)

• Gestión de escenas: Información de escena, limpieza, optimización

• Operaciones por lotes: Creación y transformación de múltiples objetos

• Avanzado: Sistemas de partículas, campos de fuerza, lápiz de cera (grease pencil)

🔧 Configuración

Puedes personalizar el servidor editando la clase Config en blender_mcp.py:

class Config:
    HOST = "0.0.0.0"           # Server host
    PORT = 8000                # Server port
    AUTO_INSTALL_PACKAGES = True  # Auto-install dependencies
    THREAD_SAFE_OPERATIONS = True  # Enable thread-safe execution
    ENABLE_CACHING = True      # Enable result caching

📋 Requisitos

El complemento instala automáticamente estas dependencias:

• FastAPI

• Uvicorn

• Pydantic

• docstring-parser

• NumPy

• PolyMCP

Versión de Blender: 3.0.0 o superior

🐛 Solución de problemas

¿El servidor no inicia?

• Comprueba la consola del sistema de Blender para ver mensajes de error (Window → Toggle System Console)

• Asegúrate de que el puerto 8000 no esté ya en uso

• Intenta reiniciar Blender después de la instalación

¿Las dependencias no se instalan?

• Instala manualmente los paquetes usando el Python de Blender:

/path/to/blender/python -m pip install fastapi uvicorn pydantic docstring-parser numpy

¿No encuentras el panel del servidor MCP?

• Presiona N en la vista 3D

• Busca la pestaña "MCP Server" en la barra lateral

• Asegúrate de que el complemento esté habilitado en las Preferencias

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Este proyecto demuestra lo sencillo que es crear potentes servidores MCP para PolyMCP.

📝 Licencia

Licencia MIT - Consulta el archivo LICENSE para más detalles

🔗 Proyectos relacionados

• PolyMCP - Forma sencilla y eficiente de interactuar con servidores MCP usando agentes personalizados

• Model Context Protocol - Protocolo abierto para la integración de herramientas con LLMs

💡 ¿Por qué este proyecto?

Este servidor MCP fue creado para demostrar lo increíblemente sencillo que hace PolyMCP la construcción de herramientas impulsadas por IA. Con solo unas pocas líneas de código, puedes:

1. Exponer funcionalidades complejas de Blender como herramientas MCP

2. Permitir que los agentes de IA descubran y orquesten estas herramientas

3. Construir interfaces de lenguaje natural para la creación 3D

Sin prompts complejos, sin selección manual de herramientas, sin gestión de estado: ¡PolyMCP lo maneja todo!

Diseñado para PolyMCP

¡Dale una estrella ⭐ a este repositorio si te resulta útil!