EnergyPlus MCP es un servidor MCP para controlar modelos de simulación energética EnergyPlus desde un asistente IA. El repositorio LBNL-ETA/EnergyPlus-MCP está publicado por la organización GitHub LBNL-ETA y describe 35 herramientas para cargar, validar, modificar, simular y analizar archivos IDF. En la verificación de GitHub del 26 de agosto de 2026, el repositorio tenía 111 estrellas y 24 forks; la API GitHub indicaba NOASSERTION para la licencia, mientras pyproject.toml declaraba BSD-3-Clause-LBNL.
Para Educasium, este conector es distinto de los MCP de dibujo o cartografía. No sirve solo para producir una imagen o manipular una escena. Pone la IA frente a un motor de simulación de edificios, con archivos IDF, clima, zonas térmicas, materiales, horarios, cargas internas, HVAC, salidas y resultados. El ángulo editorial correcto es la simulación asistida con verificación estricta de hipótesis.
Índice
- Qué hace EnergyPlus MCP
- Instalación y ciclo de vida del servidor
- Modelo, inspección y modificación IDF
- Simulación, resultados y visualización
- Autenticación HTTP y límites operativos
- Comparación con Mapbox y QGIS
- Posición de Educasium
Qué hace EnergyPlus MCP
Resumen: EnergyPlus MCP da a un asistente IA 35 herramientas para trabajar con el ciclo de vida de un modelo EnergyPlus, desde la lectura del IDF hasta gráficos de resultados. El README indica compatibilidad EnergyPlus 26.1.0 por defecto y Python 3.10 o superior.
Un MCP para simulación de edificios
EnergyPlus se usa para simular el rendimiento energético de edificios. El servidor MCP hace ese trabajo accesible por conversación, pero no cambia la naturaleza profesional del análisis. Hipótesis de modelo, clima, horarios, cargas internas, materiales y sistemas siguen siendo determinantes.
El README agrupa las capacidades en carga y configuración, inspección, modificación, simulación y gestión del servidor. Los ejemplos muestran un flujo simple: cargar un IDF, inspeccionar zonas, lanzar una simulación con archivo meteorológico EPW y crear una visualización interactiva.
Por qué es sensible
Una simulación energética puede producir números que parecen muy precisos. Pero la precisión mostrada no prueba que el modelo sea correcto. Si el IDF está incompleto, el clima no corresponde al sitio, los horarios de ocupación son falsos o el HVAC está mal modelado, el resultado puede engañar.
Ese matiz evita prometer auditoría energética automática. EnergyPlus MCP es un asistente de manipulación y exploración. La validación pertenece a la metodología de simulación, normas aplicables y profesional responsable.
Instalación y ciclo de vida del servidor
Resumen: el camino recomendado usa Docker, una imagen local energyplus-mcp-dev y un servidor Python lanzado desde energyplus-mcp-server. El README detalla configuraciones para Claude Desktop, VS Code y Cursor.
Requisitos documentados
El README lista Docker Desktop o Docker Engine, git y una imagen Docker construida localmente. El flujo clona el repositorio, construye la imagen desde .devcontainer/Dockerfile y configura el cliente MCP para ejecutar docker run con montaje del repositorio, directorio /workspace/energyplus-mcp-server y comando uv run python -m energyplus_mcp_server.server.
El pyproject verificado indica energyplus-mcp-server 0.1.0, Python >=3.10 y dependencias como mcp[cli] >=1.10, eppy, matplotlib, networkx, pandas, plotly, graphviz, uvicorn[standard] y python-dotenv. El README precisa que el desarrollo local es posible si EnergyPlus está instalado.
Ciclo práctico
El ciclo es más pesado que un MCP simple. Hay que construir la imagen, montar el directorio correcto, verificar la ruta de EnergyPlus, elegir transporte y arrancar el servidor. El README insiste en una trampa Docker: no pasar al contenedor un EPLUS_IDD_PATH que apunta a una ruta del host inexistente dentro de la imagen.
En formación conviene preparar todo antes. Un fallo Docker, una ruta Windows mal escapada o una imagen no construida consume el tiempo del taller. El primer control debe ser estado del servidor, luego lista de archivos disponibles y carga de un IDF de ejemplo.
Modelo, inspección y modificación IDF
Resumen: las herramientas cubren lectura, validación, resumen, zonas, superficies, materiales, horarios, cargas internas y modificaciones específicas. Es útil para aprender el modelo, pero peligroso si se modifica sin copia.
Inspección del modelo
La lista del README incluye load_idf_model, validate_idf, list_available_files, copy_file, get_model_summary, check_simulation_settings y get_server_configuration para carga y configuración. La inspección cubre list_zones, get_surfaces, get_materials, inspect_schedules, inspect_people, inspect_lights, inspect_electric_equipment, get_output_variables y get_output_meters.
Esto permite un buen ejercicio pedagógico: pedir al asistente que resuma un modelo, identifique zonas térmicas, revise superficies, explique horarios de ocupación y detecte salidas solicitadas. El alumno ve que la simulación empieza antes del botón run: empieza por entender el modelo.
Modificaciones posibles
El README anuncia modify_people, modify_lights, modify_electric_equipment, change_infiltration_by_mult, add_window_film_outside, add_coating_outside, add_output_variables y add_output_meters. La revisión del código también encontró funciones internas próximas como inspect_people, modify_people, inspect_lights, modify_lights, inspect_electric_equipment y modify_electric_equipment.
Estas herramientas deben usarse sobre copias. Modificar ocupación, iluminación o equipos cambia directamente los resultados. Añadir un film solar o recubrimiento exterior puede servir para comparar escenarios, pero propiedades físicas e hipótesis deben documentarse.
Simulación, resultados y visualización
Resumen: EnergyPlus MCP puede lanzar simulaciones con clima, descubrir bucles HVAC, producir topologías y crear gráficos interactivos. Ahí el conector se vuelve útil para comparar escenarios.
Ejecutar y leer simulación
El README documenta run_energyplus_simulation con IDF, archivo meteorológico y opción annual. La simulación produce un directorio de salida que las herramientas de resultados pueden leer. La ejecución depende de EnergyPlus, clima, rutas y permisos de escritura.
Las herramientas de variables y medidores permiten descubrir o añadir salidas. Es esencial: una simulación no produce automáticamente la respuesta deseada si los outputs no están configurados. El asistente puede ayudar a pedir las variables adecuadas, pero el usuario debe entender qué miden.
HVAC y gráficos
El README anuncia discover_hvac_loops, get_loop_topology y visualize_loop_diagram. pyproject incluye networkx, graphviz y plotly, coherentes con grafos y visualizaciones. create_interactive_plot genera visualizaciones HTML desde resultados.
Para Educasium, un ejemplo útil sería comparar dos escenarios simples: infiltración base contra infiltración reducida, o vidrio base contra film solar. El ejercicio debe mostrar archivos modificados, clima, período simulado, variables seguidas y gráficos obtenidos.
Autenticación HTTP y límites operativos
Resumen: stdio es el modo por defecto, pero el servidor puede funcionar en HTTP streamable con bearer tokens de al menos 32 caracteres y arranque fail-closed si faltan tokens. Es información de seguridad real.
Modo HTTP
El README describe MCP_TRANSPORT=streamable-http, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_PATH y MCP_TOKENS. Los tokens deben ser una lista JSON de objetos label y token. Los labels tienen formato corto en minúsculas, los tokens deben ser únicos y una lista vacía en modo HTTP impide arrancar el servidor.
Ese comportamiento es sano: en HTTP, un servidor de simulación expuesto sin autenticación sería mala idea. Incluso localmente, hay que saber quién alcanza el puerto, dónde se montan los archivos y qué rutas puede leer o escribir el contenedor.
Límites que explicitar
EnergyPlus MCP no sustituye un motor regulatorio nacional ni una certificación. El README cita EnergyPlus 26.1.0 por defecto, pero también explica cómo reconstruir la imagen para otra versión. Eso significa que la versión del motor forma parte del resultado.
Una página Educasium debe pedir documentar versión EnergyPlus, IDF, EPW, período, outputs, modificaciones y entorno de ejecución. Sin ese registro, dos resultados son difíciles de comparar.
Comparación con Mapbox y QGIS
Resumen: EnergyPlus MCP trabaja sobre rendimiento de un modelo edificio; Mapbox MCP sobre localización; QGIS MCP sobre capas geográficas. Los tres pueden estar en una misma cadena, pero no responden al mismo nivel.
| Necesidad | EnergyPlus MCP | QGIS MCP | Mapbox MCP |
|---|---|---|---|
| Cargar y validar un IDF | Muy adecuado | Fuera de alcance | Fuera de alcance |
| Modificar cargas, horarios o salidas | Muy adecuado | Fuera de alcance | Fuera de alcance |
| Producir mapa de accesibilidad | Fuera de alcance | Adecuado | Muy adecuado |
| Cruzar zonificaciones y restricciones | Fuera de alcance | Muy adecuado | Limitado |
| Comparar escenarios energéticos | Muy adecuado | Contexto posible | Contexto de sitio |
Orden lógico
Mapbox puede ayudar a situar un proyecto y entender su accesibilidad. QGIS puede consolidar restricciones territoriales y capas de contexto. EnergyPlus interviene cuando existe un modelo de edificio y la pregunta trata consumo, confort, cargas internas, envolvente o sistemas.
Este orden evita pedir a EnergyPlus MCP cosas que no hace, como buscar una dirección, y pedir a Mapbox cosas que no hace, como simular una zona térmica.
Posición de Educasium
Resumen: Educasium presenta EnergyPlus MCP como acelerador de flujo de simulación, no como generador de verdad energética. El uso serio depende de hipótesis, versiones y validación.
Qué enseñar
Un taller útil empieza con un archivo de ejemplo del repositorio. El asistente lista archivos, carga un IDF, valida el modelo, resume zonas y materiales, verifica parámetros, lanza una simulación corta y crea un gráfico. Solo después el alumno modifica una hipótesis simple sobre copia y compara resultados.
La pedagogía debe forzar trazabilidad. Cada escenario debe tener nombre, modificación precisa, clima, período y lista de salidas. Sin eso, la IA puede acelerar la confusión en vez del análisis.
Enfoque editorial
La fuente LBNL-ETA y la publicación SoftwareX citada en README dan peso al proyecto. La diferencia entre licencia detectada por GitHub y licencia declarada en pyproject sigue visible, porque esa doble verificación evita simplificar los hechos para hacer la página más comercial.