licuadora-open-mcp

blender-open-mcp es un proyecto de código abierto que integra Blender con modelos de IA locales (a través de Ollama ) mediante el Protocolo de Contexto de Modelo (MCP). Esto permite controlar Blender mediante indicaciones en lenguaje natural, aprovechando el poder de la IA para facilitar las tareas de modelado 3D.

Características

• Controle Blender con lenguaje natural: envíe indicaciones a un modelo Ollama que se ejecuta localmente para realizar acciones en Blender.

• Integración MCP: utiliza el protocolo de contexto de modelo para la comunicación estructurada entre el modelo de IA y Blender.

• Compatibilidad con Ollama: diseñado para funcionar con Ollama para una fácil gestión de modelos locales.

• Complemento de Blender: incluye un complemento de Blender para proporcionar una interfaz de usuario y manejar la comunicación con el servidor.

• Integración con PolyHaven (opcional): descargue y use activos (HDRI, texturas, modelos) de PolyHaven directamente en Blender a través de indicaciones de IA.

• Operaciones 3D básicas:

  • Obtener información de la escena y del objeto

  • Crear primitivos

  • Modificar y eliminar objetos

  • Aplicar materiales

• Soporte de renderizado: renderice imágenes usando la herramienta y recupere información en función del resultado.

Instalación

Prerrequisitos

1. Blender: Blender 3.0 o posterior. Descargar desde blender.org .

2. Ollama: instalar desde ollama.com , siguiendo las instrucciones específicas del sistema operativo.

3. Python: Python 3.10 o posterior.

4. uv: Instalar usando pip install uv .

5. Git: necesario para clonar el repositorio.

Pasos de instalación

1. Clonar el repositorio:

   git clone https://github.com/dhakalnirajan/blender-open-mcp.git cd blender-open-mcp

2. Crear y activar un entorno virtual (recomendado):

   uv venv source .venv/bin/activate # On Linux/macOS .venv\Scripts\activate # On Windows

3. Dependencias de instalación:

   uv pip install -e .

4. Instalar el complemento Blender:

   • Abra Blender.

   • Vaya a Edit -> Preferences -> Add-ons .

   • Haga clic en Install... .

   • Seleccione el archivo addon.py del directorio blender-open-mcp .

   • Habilite el complemento “Blender MCP”.

5. Descargue un modelo de Ollama (si aún no está instalado):

   ollama run llama3.2

   (También se pueden utilizar otros modelos como

Configuración

1. Inicie el servidor Ollama: asegúrese de que Ollama esté ejecutándose en segundo plano.

2. Inicie el servidor MCP:

   blender-mcp

   O,

   python src/blender_open_mcp/server.py

   De forma predeterminada, escucha en http://0.0.0.0:8000 , pero puedes modificar la configuración:

   blender-mcp --host 127.0.0.1 --port 8001 --ollama-url http://localhost:11434 --ollama-model llama3.2

3. Inicie el servidor de complementos de Blender:

   • Abra Blender y la ventana gráfica 3D.

   • Presione N para abrir la barra lateral.

   • Busque el panel "Blender MCP".

   • Haga clic en "Iniciar servidor MCP".

Uso

Interactúe con blender-open-mcp usando la herramienta de línea de comandos mcp :

Comandos de ejemplo

• Indicación básica:

  mcp prompt "Hello BlenderMCP!" --host http://localhost:8000

• Obtener información de la escena:

  mcp tool get_scene_info --host http://localhost:8000

• Crear un cubo:

  mcp prompt "Create a cube named 'my_cube'." --host http://localhost:8000

• Renderizar una imagen:

  mcp prompt "Render the image." --host http://localhost:8000

• Usando PolyHaven (si está habilitado):

  mcp prompt "Download a texture from PolyHaven." --host http://localhost:8000

Herramientas disponibles

Solución de problemas

Si encuentra problemas:

• Asegúrese de que Ollama y el servidor blender-open-mcp estén ejecutándose.

• Verifique la configuración de complementos de Blender.

• Verificar los argumentos de la línea de comandos.

• Consulte los registros para obtener detalles de los errores.

Para obtener más ayuda, visita la página de problemas de GitHub .

¡Feliz fusión con IA! 🚀