MCP_Dialux

Del plano de un ejercicio de iluminación al edificio construido en DIALux evo, sin dibujarlo a mano.

MCP_Dialux es un servidor MCP que lee el plano DWG de un ejercicio de luminotecnia —incluido el enunciado que el profesor escribe dentro del propio plano—, consulta lo que exige la norma UNE-EN 12464-1 para cada tipo de local y genera un fichero que DIALux evo importa con las estancias ya levantadas.

Se usa hablando con un asistente de IA, sin tocar la línea de comandos:

— Construye el edificio del examen Examen-junio.dwg

— El plano no dice la altura de las salas. ¿Qué altura tienen?

— 3 metros

— Listo: 7 salas en 2 plantas, en salida/Examen-junio.stf. Las 6 cotas del plano cuadran con las medidas reconstruidas. En Archivos hay una columna de 0,66 × 0,63 m en (22,18 ; 6,65) que tendrás que poner a mano.

El punto de partida: muros dibujados como líneas sueltas, el enunciado escrito dentro del dibujo y el uso de cada zona con su referencia de la norma.

Lo que la herramienta entiende, y que es lo que acaba en DIALux. Las cotas del dibujo sirven de comprobación: si no cuadran con las salas reconstruidas, avisa.

El resultado: el mismo plano ya levantado en DIALux evo, con sus paredes y su altura, listo para colocar luminarias y calcular.

Por qué existe

En clase de iluminación el ejercicio siempre empieza igual: un plano en DWG, un enunciado con los datos del local y un catálogo de luminarias. Después hay que montarlo en DIALux evo, que es el programa estándar del sector, y calcular.

Montar el edificio es la parte lenta y la que no enseña nada: dibujar paredes siguiendo un plano que ya existe. Este proyecto la automatiza, para poder dedicar el tiempo al cálculo y, sobre todo, para comparar el edificio generado con el que uno ha hecho a mano y detectar dónde se ha equivocado.

Related MCP server: best-cad-mcp

Qué hace

Un ejemplo real

El examen final de junio es un edificio de dos plantas con nueve zonas. De su plano salen, sin escribir un dato a mano:

• Las salas, reconstruidas a partir de muros dibujados como líneas sueltas: oficina en L de 214 m², archivos, sala de atención médica, baños, pasillo y dos huecos de ascensor.

• Los datos de cada zona, que la profesora escribe como texto dentro del plano: altura del plano de trabajo, zona marginal, factor de mantenimiento y el tipo de actividad según la norma (34.2 Oficina, 10.7 Sala para atención médica…).

• Las columnas que hay dentro de dos salas, con su tamaño y su posición.

• Las puertas y las ventanas, deducidas de los huecos que quedan en los muros: en fachada un hueco ancho es una ventana y uno estrecho la entrada; hacia dentro, un paso entre salas.

• La comprobación: las 6 cotas del dibujo coinciden con las medidas reconstruidas.

Cómo funciona

 .dwg  ──ODA File Converter──►  .dxf  ──ezdxf──►  geometría + textos
                                                        │
          ┌─────────────────────────────────────────────┤
          ▼                                             ▼
   reconstruir salas                            leer el enunciado
   (shapely)                                    (altura, plano de
          │                                      trabajo, actividad)
          └─────────────────┬───────────────────────────┘
                            ▼
                   comprobar con las cotas
                            │
                            ▼
                    escribir el .stf ──────►  DIALux evo

Tres problemas interesantes por el camino:

1. En el plano no hay ninguna sala. Los muros son polilíneas abiertas, con la cara interior y la exterior por separado y huecos en las puertas; las capas no distinguen un muro de una cota. Las salas se reconstruyen cerrando los huecos entre tramos alineados, poligonizando el dibujo y quedándose con las caras cuya anchura media supera el grosor de un muro. Un detalle que costó encontrar: DIALux importa mal una pared que toca a dos salas si no hay un vértice justo donde acaba la pared del vecino, así que las paredes se parten automáticamente en esos puntos.

2. El enunciado va dentro del plano, como texto suelto. Cada texto se asigna a la sala que lo contiene, y los párrafos que quedan fuera del dibujo se agrupan y se asignan por su encabezado ("Sobre los baños"). Lo que no se reconoce con seguridad no se interpreta: se devuelve tal cual para que lo lea el asistente.

3. La norma es un PDF de 114 páginas. Las tablas de la UNE-EN 12464-1:2022 se leen localizando las columnas por su cabecera en cada tabla, porque cambian de posición incluso dentro de la misma página. De 319 filas se leen 314; las 5 restantes son títulos de grupo o filas con casillas vacías en la propia norma, y se devuelven como "consúltala en el PDF" en vez de rellenarlas. Contrastadas con una lectura independiente, coinciden las 303 filas comparables.

Ingeniería inversa del formato STF

DIALux evo importa arquitectura en tres formatos: IFC (solo en la versión de pago), DX4 (del DIALux clásico) y STF. STF es el único camino gratuito, y su especificación no es pública: DIAL la envía por correo a quien la pide.

El generador de este proyecto se escribió deduciendo el formato de dos exportadores de código abierto —STF-Exporter para Revit y DIALux_Toolkit de BHoM— y validando cada campo importando ficheros de prueba en DIALux evo 14. Después, el soporte de DIAL envió la especificación oficial a quien la pidió, que confirmó los hallazgos y corrigió un campo deducido mal. El documento es confidencial y no se incluye aquí.

Lo que se averiguó probando, antes de tener el documento:

Como el formato no sabe de plantas, las de un mismo edificio se escriben separadas en el plano, con un desplazamiento redondo que la herramienta indica, y cada sala lleva su planta en el nombre (Archivos [segunda]) para poder repartirlas dentro de DIALux.

Comparar con el proyecto hecho a mano

DIALux evo no exporta STF, pero sí exporta el plano a DWG. Ese DWG viene en capas (DLX_CALC con la superficie de cálculo de cada sala, DLX_DESC con los nombres, DLX_CONT con los muros en 3D y DLX_OBJ con los objetos), así que se puede leer y contrastar sala por sala con el edificio generado: medidas, superficies, alturas, plano de trabajo y columnas.

Es lo que cierra el círculo del proyecto: montar el ejercicio a mano, exportarlo y ver en qué se diferencia del que sale del plano. Lo que el DWG no trae —factor de mantenimiento, luminarias, puertas y ventanas— se informa aparte en vez de contarlo como diferencia.

Decisiones de diseño

• Nunca inventar un dato. Si el plano no dice la altura de las salas, no se escribe ningún fichero: se devuelve qué falta y para qué salas. Un edificio con una altura inventada parece correcto, y eso es peor que no tener nada.

• Los valores de la norma salen del PDF del usuario, no están copiados en el código, y cada respuesta dice de qué tabla, fila y página viene para poder comprobarla en el papel.

• Lo que la herramienta no puede hacer, lo dice con números. Las columnas y la zona marginal no caben en el STF, así que se devuelven con su valor y su posición ya calculados, para no tener que volver al plano.

• Cada regla del código tiene al lado la medición que la justifica, con la fecha en la que se comprobó.

Con qué muros se choca DIALux evo

Casi todo el trabajo manual que queda no es del programa que hay aquí, sino de lo que el ecosistema de DIALux evo deja o no deja hacer. Cada línea está comprobada importando ficheros en evo 14, y las tres primeras confirmadas además por el soporte de DIAL:

Dos rarezas de esa exportación a DWG, por si alguien la lee: el fichero declara pulgadas aunque se exporte en metros, y la envolvente exterior sale con el forjado incluido, midiendo 3,2 m donde la sala mide 3. Las dos están resueltas en el código.

Limitaciones del proyecto

• Las luminarias todavía no se colocan: el edificio llega a DIALux vacío. El formato STF las admite, incluso en retícula, y es el siguiente paso.

• Probado con planos de AutoCAD 2023 y 2024 en metros; otros orígenes pueden necesitar ajustes.

• La lectura de un plano se apoya en convenciones de dibujo (muros de doble línea, huecos en las puertas, el enunciado como texto): con un plano muy distinto habría que medir de nuevo los umbrales de geometria.py.

Probarlo sin tener un plano

El repositorio trae un plano de ejemplo, ejemplos/plano-ejemplo.dxf, con el mismo estilo que los de clase: muros de doble línea, huecos de puerta, una columna, el enunciado escrito dentro y las cotas. Es el de las imágenes de arriba, y se puede regenerar con python ejemplos/generar_plano_ejemplo.py.

Basta con pedirle al asistente:

Construye el edificio de ejemplos/plano-ejemplo.dxf

Instalación

Requisitos:

• Python 3.12 o superior

• ODA File Converter, gratuito, para leer DWG (ezdxf solo lee DXF)

• DIALux evo (Windows) para importar el resultado

• Tu copia del PDF de la UNE-EN 12464-1 en material/norma/, si quieres las herramientas de norma

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python -m pytest -q pruebas

En Windows:

py -m venv $HOME\.venvs\mcp_dialux
~\.venvs\mcp_dialux\Scripts\pip install -r requirements.txt
~\.venvs\mcp_dialux\Scripts\python -m pytest -q pruebas

Conectar con un cliente MCP

En Claude Desktop: Ajustes → Desarrollador → Editar configuración, y añadir el servidor a claude_desktop_config.json. Después, cerrar la aplicación del todo y volver a abrirla.

{
  "mcpServers": {
    "dialux": {
      "command": "/ruta/al/proyecto/.venv/bin/python",
      "args": ["/ruta/al/proyecto/server.py"]
    }
  }
}

En Windows, las rutas van con doble barra: "C:\\Users\\tu-usuario\\.venvs\\mcp_dialux\\Scripts\\python.exe".

Si ODA File Converter no está en su carpeta habitual, se le indica con "env": {"ODA_FILE_CONVERTER": "ruta al ejecutable"}.

Estructura

server.py              el servidor MCP: solo declara las herramientas
dialux/
  cad/convertir.py     DWG → DXF con ODA, igual en macOS y en Windows, con caché por hash
  cad/geometria.py     reconstruir las salas del plano
  cad/enunciado.py     leer los datos del ejercicio de los textos del plano
  cad/plano.py         leer_plano: lo junta y lo comprueba contra las cotas
  norma.py             las tablas de la UNE-EN 12464-1, leídas del PDF
  leer_stf.py          leer un STF y comparar dos edificios
  export_dialux.py     leer el DWG que exporta DIALux evo, para comparar con lo hecho a mano
  stf.py               escribir el fichero que importa DIALux evo
  construir.py         del plano al edificio
ejemplos/              un plano de ejemplo para probar la herramienta sin material de clase
docs/imagenes/         las imágenes de este README
pruebas/               40 pruebas, sobre el plano de ejemplo y sobre planos de examen reales

Los planos de clase, el PDF de la norma y las fichas de luminarias no se incluyen en el repositorio: son material de la asignatura.

Pruebas

.venv/bin/python -m pytest -q pruebas

Las pruebas se apoyan en los exámenes reales y se saltan solas si no están. Cada una documenta el fallo que la hizo necesaria: la diagonal del pasillo, los textos de dos salas que se asignaron al revés, las filas de la norma con los miles escritos sin espacio.

Licencia

MIT. Ver LICENSE.