local-only server

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

Integrations

Enables interactions with IFC (Industry Foundation Classes) models through Bonsai BIM, allowing users to query models, analyze spatial structures, inspect project information, and examine building elements and their relationships.
Provides tools for executing Python code in Blender, creating and modifying 3D objects, applying materials, and analyzing IFC models through a socket-based connection.

Bonsai-mcp - Integración del protocolo de contexto del modelo de Blender para IFC a través de IfcOpenShell

Bonsai-mcp es una bifurcación de BlenderMCP que amplía la funcionalidad original con soporte dedicado para modelos IFC (Industry Foundation Classes) a través de Bonsai. Esta integración es una prueba de concepto rápida que busca ejemplificar las capacidades de conectar Claude, o cualquier LLM (aunque esto solo se probó con el cliente de escritorio de Claude), a Blender para ejecutar comandos IfcOpenShell.

Características

Funcionalidad específica de IFC : consulte modelos IFC, analice estructuras espaciales y examine elementos de construcción
Cinco potentes herramientas IFC : inspeccionar información del proyecto, enumerar entidades, examinar propiedades, explorar la estructura espacial y analizar relaciones
Pensamiento secuencial : incluye la herramienta de pensamiento secuencial de modelcontextprotocol/servers para la resolución estructurada de problemas.
Herramienta Ejecutar código de la implementación original de BlenderMCP : crea y modifica objetos, aplica materiales y ejecuta código Python en Blender
Probado con modelos estándar : verificado funcionando con el modelo de casa ifcopenshell predeterminado ( AC20-FZK-Haus.ifc )

Componentes

El sistema consta de dos componentes principales:

Complemento de Blender ( addon.py ) : un complemento de Blender que crea un servidor de socket dentro de Blender para recibir y ejecutar comandos, incluidas operaciones específicas de IFC
Servidor MCP ( blender_mcp_tools.py ) : un servidor Python que implementa el Protocolo de contexto de modelo y se conecta al complemento Blender

Instalación

Prerrequisitos

Blender 3.0 o más reciente
Python 3.10 o más reciente
administrador de paquetes uv
Complemento Bonsai BIM para Blender (para funcionalidad IFC)

Instalación de uv:

Impermeable:

brew install uv

Ventanas:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 
set Path=C:\Users\[username]\.local\bin;%Path%

Para otras plataformas, consulte la guía de instalación de uv .

Clonar el repositorio

git clone https://github.com/JotaDeRodriguez/Bonsai_mcp

Claude para integración de escritorio

Edite su archivo claude_desktop_config.json (Claude > Configuración > Desarrollador > Editar configuración) para incluir:

{
    "mcpServers": {
        "Bonsai-mcp": {
            "command": "uv",
            "args": [
              "--directory",
              "\\your\\path\\to\\Bonsai_mcp",
              "run",
              "tools.py"
          ]
        }
    }
}

Instalación del complemento Blender

Descargue el archivo addon.py desde este repositorio
Abra Blender
Vaya a Editar > Preferencias > Complementos
Haga clic en "Instalar..." y seleccione el archivo addon.py
Habilite el complemento marcando la casilla junto a "Interfaz: Blender MCP - IFC".

Uso

Iniciando la conexión

En Blender, vaya a la barra lateral Vista 3D (presione N si no está visible)
Busque la pestaña "Blender MCP - IFC"
Haga clic en "Conectarse a Claude"
Asegúrese de que el servidor MCP esté en ejecución

Usando con Claude

Una vez conectado, verás un ícono de martillo en la interfaz de Claude con herramientas para la integración de Blender MCP IFC.

Herramientas IFC

Esta bifurcación agrega cinco potentes herramientas específicas de IFC:

1. obtener_información_del_proyecto_ifc

Obtenga información básica sobre el proyecto IFC, incluido el nombre, la descripción y el número de diferentes tipos de entidades.

Ejemplo: "¿Cuál es la información básica sobre este proyecto de la CFI?"

2. lista_entidades_ifc

Enumere entidades IFC de un tipo específico (paredes, puertas, espacios, etc.).

Ejemplo: "Enumera todas las paredes de este modelo IFC" o "Muéstrame las ventanas de este edificio"

3. obtener_propiedades_ifc

Obtenga todas las propiedades de una entidad IFC específica por su GlobalId.

Ejemplo: "¿Cuáles son las propiedades de este muro con ID 1Dvrgv7Tf5IfTEapMkwDQY?"

4. obtener_estructura_espacial_ifc

Obtenga la jerarquía espacial del modelo IFC (sitio, edificio, pisos, espacios).

Ejemplo: "Muéstrame la estructura espacial de este edificio"

5. obtener_relaciones_ifc

Obtenga todas las relaciones para una entidad IFC específica.

Ejemplo: "¿Cuáles son las relaciones de la puerta de entrada?"

Ejecutar código de Blender

Característica heredada de la implementación original de MCP. Permite a Claude ejecutar código Python arbitrario en Blender. Úsela con precaución.

Herramienta de pensamiento secuencial

Esta integración también incluye la herramienta Pensamiento Secuencial, que facilita un proceso de pensamiento detallado, paso a paso, para la resolución y análisis de problemas.

Parámetros de la herramienta:

thought (cadena): El paso de pensamiento actual
nextThoughtNeeded (booleano): si se necesita otro paso de pensamiento
thoughtNumber (entero): Número de pensamiento actual
totalThoughts (entero): Total estimado de pensamientos necesarios
isRevision (booleano, opcional): si esto revisa el pensamiento previo
revisesThought (entero, opcional): ¿Qué pensamiento se está reconsiderando?
branchFromThought (entero, opcional): número de pensamiento del punto de ramificación
branchId (cadena, opcional): identificador de rama
needsMoreThoughts (booleano, opcional): Si se necesitan más pensamientos

Ejemplo: "Utilice el pensamiento secuencial para analizar la eficiencia energética de este edificio"

Comandos de ejemplo

A continuación se muestran algunos ejemplos de lo que puedes pedirle a Claude que haga con los modelos IFC:

"Analiza este modelo IFC y dime cuántas paredes, puertas y ventanas tiene"
"Muéstrame la estructura espacial de este modelo de edificio"
"Enumere todos los espacios en este modelo IFC y sus propiedades"
"Identifique todos los elementos estructurales de este edificio"
"¿Cuáles son las relaciones entre este muro y otros elementos?"
Utilice el pensamiento secuencial para crear un plan de mantenimiento para este edificio basado en el modelo IFC.

Solución de problemas

Problemas de conexión : asegúrese de que el servidor de complementos de Blender esté en ejecución y que el servidor MCP esté configurado en Claude
El modelo IFC no se carga : Verifique que tenga instalado el complemento Bonsai BIM y que haya cargado un archivo IFC
Errores de tiempo de espera : intente simplificar sus solicitudes o dividirlas en pasos más pequeños

Detalles técnicos

La integración con IFC utiliza el módulo Bonsai BIM para acceder a la funcionalidad ifcopenshell dentro de Blender. La comunicación sigue el mismo protocolo basado en JSON a través de sockets TCP que el BlenderMCP original.

Limitaciones y consideraciones de seguridad

La herramienta execute_blender_code del proyecto original sigue disponible, lo que permite ejecutar código Python arbitrario en Blender. Úsela con precaución y guarde siempre su trabajo.
Los modelos IFC complejos pueden requerir dividir las operaciones en pasos más pequeños.
El rendimiento de la consulta IFC depende del tamaño y la complejidad del modelo.

Créditos

BlenderMCP original de Siddharth Ahuja
Herramienta de pensamiento secuencial de modelcontextprotocol/servers
Integración de IFC basada en el complemento Bonsai BIM para Blender

HACER

Implementación del cursor Agregar descripción 'get_selected_ifc_elements'

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de protocolo de contexto de modelo que integra Claude con Blender, permitiendo a los usuarios analizar e interactuar con modelos de construcción IFC (Industry Foundation Classes) a través de comandos de lenguaje natural.