local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables control of Blender using natural language prompts, allowing for 3D modeling tasks such as creating and modifying objects, applying materials, and rendering images through a Blender add-on that handles communication with the server.
Uses locally running Ollama models to process natural language commands, with the ability to switch between different models like llama3.2 or Gemma3, and query available models from the Ollama server.

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

Blender: Blender 3.0 o posterior. Descargar desde blender.org .
Ollama: instalar desde ollama.com , siguiendo las instrucciones específicas del sistema operativo.
Python: Python 3.10 o posterior.
uv: Instalar usando pip install uv .
Git: necesario para clonar el repositorio.

Pasos de instalación

Clonar el repositorio:
git clone https://github.com/dhakalnirajan/blender-open-mcp.git cd blender-open-mcp
Crear y activar un entorno virtual (recomendado):
uv venv source .venv/bin/activate # On Linux/macOS .venv\Scripts\activate # On Windows
Dependencias de instalación:
uv pip install -e .
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”.
Descargue un modelo de Ollama (si aún no está instalado):
ollama run llama3.2
(También se pueden utilizar otros modelos como Gemma3 .)

Configuración

Inicie el servidor Ollama: asegúrese de que Ollama esté ejecutándose en segundo plano.
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
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

Nombre de la herramienta	Descripción	Parámetros
`get_scene_info`	Recupera detalles de la escena.	Ninguno
`get_object_info`	Recupera información sobre un objeto.	`object_name` (str)
`create_object`	Crea un objeto 3D.	`type` , `name` , `location` , `rotation` , `scale`
`modify_object`	Modifica las propiedades de un objeto.	`name` , `location` , `rotation` , `scale` , `visible`
`delete_object`	Elimina un objeto.	`name` (str)
`set_material`	Asigna un material a un objeto.	`object_name` , `material_name` , `color`
`render_image`	Representa una imagen.	`file_path` (str)
`execute_blender_code`	Ejecuta código Python en Blender.	`code` (str)
`get_polyhaven_categories`	Enumera las categorías de activos de PolyHaven.	`asset_type` (cadena)
`search_polyhaven_assets`	Busca activos de PolyHaven.	`asset_type` , `categories`
`download_polyhaven_asset`	Descarga un activo de PolyHaven.	`asset_id` , `asset_type` , `resolution` , `file_format`
`set_texture`	Aplica una textura descargada.	`object_name` , `texture_id`
`set_ollama_model`	Establece el modelo Ollama.	`model_name` (str)
`set_ollama_url`	Establece la URL del servidor Ollama.	`url` (cadena)
`get_ollama_models`	Enumera los modelos de Ollama disponibles.	Ninguno

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! 🚀

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor que integra Blender con modelos de IA locales a través del Protocolo de Contexto de Modelo, lo que permite a los usuarios controlar Blender utilizando indicaciones en lenguaje natural para tareas de modelado 3D.

Blender Open MCP