EnergyPlus MCP est un serveur MCP pour piloter des modèles de simulation énergétique EnergyPlus depuis un assistant IA. Le dépôt LBNL-ETA/EnergyPlus-MCP est publié par l'organisation GitHub LBNL-ETA et décrit 35 outils pour charger, valider, modifier, simuler et analyser des fichiers IDF. Lors de la vérification GitHub du 26 août 2026, le dépôt comptait 111 étoiles et 24 forks ; l'API GitHub indiquait NOASSERTION pour la licence, tandis que pyproject.toml déclarait BSD-3-Clause-LBNL.
Pour Educasium, ce connecteur est différent des MCP de dessin ou de cartographie. Il ne sert pas seulement à produire une image ou à manipuler une scène. Il met l'IA face à un moteur de simulation bâtiment, avec fichiers IDF, météo, zones thermiques, matériaux, horaires, charges internes, CVC, sorties et résultats. Le bon angle éditorial est donc la simulation assistée, avec vérification stricte des hypothèses.
Sommaire
- Ce que fait EnergyPlus MCP
- Installation et cycle de vie du serveur
- Modèle, inspection et modification IDF
- Simulation, résultats et visualisation
- Authentification HTTP et limites opérationnelles
- Comparaison avec Mapbox et QGIS
- Position Educasium
Ce que fait EnergyPlus MCP
À retenir : EnergyPlus MCP donne à un assistant IA 35 outils pour travailler sur le cycle de vie d'un modèle EnergyPlus, de la lecture du fichier IDF jusqu'aux graphiques de résultats. Le README indique une compatibilité EnergyPlus 26.1.0 par défaut et Python 3.10 ou plus.
Un MCP pour la simulation bâtiment
EnergyPlus est utilisé pour simuler les performances énergétiques des bâtiments. Le serveur MCP rend ce travail accessible par une interface de conversation, mais il ne change pas la nature du métier. Les hypothèses de modèle, météo, horaires, charges internes, matériaux et systèmes restent déterminantes.
Le README regroupe les capacités en modèle et chargement, inspection, modification, simulation et gestion du serveur. Les exemples montrent un flux simple : charger un fichier IDF, inspecter les zones, lancer une simulation avec un fichier météo EPW, puis créer une visualisation interactive.
Pourquoi c'est sensible
Une simulation énergétique peut produire des nombres très précis en apparence. Mais la précision affichée n'est pas une preuve de justesse. Si l'IDF est incomplet, si le fichier météo ne correspond pas au site, si les horaires d'occupation sont faux ou si les systèmes CVC sont mal modélisés, le résultat peut être trompeur.
Cette nuance écarte la promesse d'un audit énergétique automatique. EnergyPlus MCP est un assistant de manipulation et d'exploration. La validation appartient toujours à la méthode de simulation, aux normes applicables et au professionnel responsable.
Installation et cycle de vie du serveur
À retenir : le chemin recommandé repose sur Docker, une image locale energyplus-mcp-dev et un serveur Python lancé dans le dossier energyplus-mcp-server. Le README détaille des configurations pour Claude Desktop, VS Code et Cursor.
Prérequis documentés
Le README liste Docker Desktop ou Docker Engine, git et une image Docker construite localement. La commande de base clone le dépôt, construit l'image depuis .devcontainer/Dockerfile, puis configure le client MCP pour exécuter docker run avec montage du dépôt, répertoire de travail /workspace/energyplus-mcp-server et commande uv run python -m energyplus_mcp_server.server.
Le pyproject vérifié dans energyplus-mcp-server indique le package energyplus-mcp-server en version 0.1.0, Python >=3.10 et des dépendances comme mcp[cli] >=1.10, eppy, matplotlib, networkx, pandas, plotly, graphviz, uvicorn[standard] et python-dotenv. Le README précise qu'un développement local est possible si EnergyPlus est installé sur la machine.
Cycle de vie pratique
Le cycle de vie est plus lourd qu'un MCP simple. Il faut construire l'image, monter le bon dossier, vérifier le chemin EnergyPlus, choisir le transport, puis démarrer le serveur. Le README insiste sur un piège Docker : ne pas transmettre au conteneur un EPLUS_IDD_PATH pointant vers un chemin hôte inexistant dans l'image.
Dans une formation, ce cycle doit être préparé avant le cours. Une panne Docker, un chemin Windows mal échappé ou une image non construite consomme vite tout le temps. Le premier contrôle doit être l'état du serveur, puis la liste des fichiers disponibles, puis le chargement d'un exemple IDF.
Modèle, inspection et modification IDF
À retenir : les outils couvrent lecture, validation, résumé, zones, surfaces, matériaux, horaires, charges internes et modifications ciblées. C'est utile pour apprendre le modèle, mais dangereux si l'on modifie sans copie.
Inspection du modèle
La liste d'outils du README inclut load_idf_model, validate_idf, list_available_files, copy_file, get_model_summary, check_simulation_settings et get_server_configuration dans la famille chargement et configuration. L'inspection couvre list_zones, get_surfaces, get_materials, inspect_schedules, inspect_people, inspect_lights, inspect_electric_equipment, get_output_variables et get_output_meters.
Cette surface permet un bon exercice pédagogique : demander à l'assistant de résumer un modèle, identifier les zones thermiques, vérifier les surfaces, expliquer les horaires d'occupation et repérer les sorties demandées. L'apprenant voit que la simulation commence avant le bouton run : elle commence par comprendre ce qui est dans le modèle.
Modifications possibles
Le README annonce des outils de modification comme modify_people, modify_lights, modify_electric_equipment, change_infiltration_by_mult, add_window_film_outside, add_coating_outside, add_output_variables et add_output_meters. La vérification du code a aussi repéré des fonctions internes proches : inspect_people, modify_people, inspect_lights, modify_lights, inspect_electric_equipment et modify_electric_equipment.
Ces outils doivent être utilisés sur copie. Modifier des charges d'occupation, d'éclairage ou d'équipement change directement les résultats. Ajouter un film solaire ou un revêtement extérieur peut être pertinent pour comparer des scénarios, mais les propriétés physiques et hypothèses doivent être documentées.
Simulation, résultats et visualisation
À retenir : EnergyPlus MCP peut lancer des simulations avec météo, découvrir les boucles CVC, produire des topologies et créer des graphiques interactifs. C'est là que le connecteur devient utile pour comparer des scénarios.
Lancer et lire une simulation
Le README documente run_energyplus_simulation avec un fichier IDF, un fichier météo et une option annual dans les exemples. La simulation produit un répertoire de sortie exploitable par les outils de résultats. L'exécution dépend d'EnergyPlus, du fichier météo, des chemins et des droits d'écriture.
Les outils de variables et compteurs permettent de découvrir ou ajouter des sorties. C'est essentiel : une simulation ne produit pas automatiquement la réponse souhaitée si les outputs ne sont pas configurés. L'assistant peut aider à demander les bonnes variables, mais l'utilisateur doit comprendre ce qu'elles mesurent.
CVC et graphiques
Le README annonce discover_hvac_loops, get_loop_topology et visualize_loop_diagram. Le pyproject inclut networkx, graphviz et plotly, cohérents avec les graphes et visualisations. create_interactive_plot génère des visualisations HTML à partir des résultats.
Pour Educasium, un bon exemple serait de comparer deux scénarios simples : infiltration de base contre infiltration réduite, ou vitrage de base contre film solaire. L'exercice doit montrer les fichiers modifiés, la météo, la période simulée, les variables suivies et les graphes obtenus.
Authentification HTTP et limites opérationnelles
À retenir : le transport stdio est le mode par défaut, mais le serveur peut fonctionner en HTTP streamable avec bearer tokens d'au moins 32 caractères et démarrage fail-closed si les tokens sont absents. C'est une vraie information de sécurité, pas un détail.
Mode HTTP
Le README décrit MCP_TRANSPORT=streamable-http, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_PATH et MCP_TOKENS. Les tokens doivent être une liste JSON d'objets label et token. Les labels doivent respecter un format court en minuscules, les tokens doivent être uniques, et une liste vide en mode HTTP empêche le serveur de démarrer.
Ce comportement est sain : en HTTP, un serveur de simulation exposé sans authentification serait une mauvaise idée. Même localement, il faut comprendre qui peut atteindre le port, où sont montés les fichiers et quels chemins le conteneur peut lire ou écrire.
Limites à expliciter
EnergyPlus MCP ne remplace pas un moteur réglementaire national ni une certification. Le README cite EnergyPlus 26.1.0 par défaut, mais il explique aussi comment reconstruire l'image pour une autre version. Cela signifie que la version du moteur fait partie du résultat.
Une pratique Educasium consiste donc à documenter version EnergyPlus, IDF, EPW, période, outputs, modifications et environnement d'exécution. Sans ce journal, deux résultats deviennent difficiles à comparer.
Comparaison avec Mapbox et QGIS
À retenir : EnergyPlus MCP travaille sur la performance d'un modèle bâtiment ; Mapbox MCP travaille sur la localisation ; QGIS MCP travaille sur les couches géographiques. Les trois peuvent se suivre dans un workflow d'étude, mais ils ne répondent pas au même niveau.
| Besoin | EnergyPlus MCP | QGIS MCP | Mapbox MCP |
|---|---|---|---|
| Charger et valider un IDF | Très adapté | Hors périmètre | Hors périmètre |
| Modifier charges, horaires ou sorties | Très adapté | Hors périmètre | Hors périmètre |
| Produire une carte d'accessibilité | Hors périmètre | Adapté | Très adapté |
| Croiser zonages et contraintes | Hors périmètre | Très adapté | Limité |
| Comparer scénarios énergétiques | Très adapté | Contexte possible | Contexte site |
Ordre logique
Mapbox peut aider à situer un projet et comprendre son accessibilité. QGIS peut consolider les contraintes territoriales et les couches de contexte. EnergyPlus intervient quand un modèle du bâtiment existe et qu'une question porte sur consommation, confort, charges internes, enveloppe ou systèmes.
Cet ordre empêche de demander à EnergyPlus MCP des choses qu'il ne fait pas, comme rechercher une adresse, et de demander à Mapbox des choses qu'il ne fait pas, comme simuler une zone thermique.
Position Educasium
À retenir : Educasium présente EnergyPlus MCP comme un accélérateur de workflow de simulation, pas comme un générateur de vérité énergétique. L'usage sérieux repose sur hypothèses, versions et validation.
Ce qu'il faut enseigner
Un atelier utile commence avec un fichier exemple du dépôt. L'assistant liste les fichiers, charge un IDF, valide le modèle, résume zones et matériaux, vérifie les paramètres de simulation, lance une simulation courte, puis crée un graphique. Ensuite seulement, l'apprenant modifie une hypothèse simple sur copie et compare les résultats.
La pédagogie doit forcer la traçabilité. Chaque scénario doit avoir un nom, une modification précise, une météo, une période et une liste de sorties. Sans cela, l'IA peut accélérer la confusion au lieu d'accélérer l'analyse.
Positionnement éditorial
La source LBNL-ETA et la publication SoftwareX citée dans le README donnent du poids au projet. La différence entre la licence détectée par GitHub et la licence déclarée dans pyproject reste néanmoins visible, car cette double vérification évite de simplifier les faits pour rendre la page plus commerciale.
La suite logique est de relier EnergyPlus MCP aux pages QGIS MCP et Mapbox MCP, puis à des modules sur la vérification des hypothèses de simulation énergétique.