EnergyPlus MCP Server
MCP-сервер из 35 инструментов для энергомоделей зданий EnergyPlus: загрузка IDF, правка параметров, расчет и графики.
- 125 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент правит и сохраняет модели IDF в смонтированном каталоге, а Docker получает доступ к этому каталогу.
- Режим HTTP открывает порт; защита ограничена bearer-токеном.
Установка
- Работает в
Ручная установка
git clone https://github.com/LBNL-ETA/EnergyPlus-MCP.git && cd EnergyPlus-MCP && docker build -t energyplus-mcp-dev -f .devcontainer/Dockerfile .devcontainerКлонирует репозиторий и один раз собирает образ с EnergyPlus; затем клиент запускает сервер командой `docker run`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент правит и сохраняет модели IDF в смонтированном каталоге, а Docker получает доступ к этому каталогу.
- Режим HTTP открывает порт; защита ограничена bearer-токеном.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
EnergyPlus MCP Server открывает ИИ-ассистенту работу с моделями энергопотребления зданий в формате IDF. Агент загружает и проверяет модель, смотрит зоны, поверхности, материалы и расписания, правит нагрузки людей, освещения и оборудования, меняет период и параметры расчета. Сервер запускает симуляцию EnergyPlus с погодным файлом, строит интерактивные HTML-графики и схемы контуров HVAC. Агент добавляет выходные переменные и счетчики, читает логи сервера. Всего 35 инструментов в пяти группах: загрузка, осмотр, правка, расчет и управление сервером. Основной транспорт stdio, для проверок есть режим streamable HTTP с токеном.
Для кого. Инженерам по энергоэффективности и исследователям, которые считают здания в EnergyPlus и хотят править IDF-модели через Claude Desktop, VS Code или Cursor.
Подходит, если
- Модель IDF разбирают по зонам и поверхностям перед расчетом.
- Сравнивают варианты: освещение, нагрузка людей, инфильтрация, пленка на окнах.
- После расчета строят интерактивные графики по выбранным переменным.
- Схему контуров HVAC хочется увидеть без ручного разбора IDF.
Не подходит, если
- Docker недоступен: клиентские примеры запускают сервер в контейнере, локальный путь требует установки EnergyPlus.
- Модель хранится не в формате IDF: сервер работает с IDF-файлами.
- Нужна другая версия EnergyPlus: образ собран под 26.1.0, для другой версии его пересобирают.
Пример запроса к агенту
Загрузи модель 1ZoneUncontrolled.idf, покажи зоны и запусти расчет с погодным файлом.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
MCP_TRANSPORT- Транспорт: `stdio` по умолчанию или `streamable-http`.
MCP_TOKENSсекрет- JSON-список bearer-токенов для режима HTTP, токен не короче 32 символов.
Ограничения
Образ по умолчанию рассчитан на EnergyPlus 26.1.0, другую версию пересобирают по описанию в README. Для запуска из клиента нужны Docker и локально собранный образ `energyplus-mcp-dev`; без Docker нужны Python 3.10 или новее, `uv` и установленный EnergyPlus. Режим HTTP требует bearer-токен не короче 32 символов в `MCP_TOKENS` и описан как локальный для проверок. Версия сервера 0.1.0, лицензия модифицированная BSD.
Как отключить. Удалите запись `energyplus` из конфигурации MCP-клиента, затем при желании `docker rmi energyplus-mcp-dev` и клонированный каталог.
Частые вопросы
Какие группы инструментов есть?
Загрузка и настройка модели, осмотр, правка, расчет с графиками и управление сервером. Среди них `load_idf_model`, `run_energyplus_simulation`, `create_interactive_plot` и `discover_hvac_loops`.
Как проверить подключение?
Спросите у клиента, какие инструменты EnergyPlus ему доступны. В списке должны быть `load_idf_model`, `run_energyplus_simulation` и `get_server_status`.
Как запустить сервер по HTTP?
Задайте `MCP_TRANSPORT=streamable-http`, `MCP_HTTP_PORT` и токены в `MCP_TOKENS`; токен создает `openssl rand -hex 32`. Клиент подключается к адресу `/mcp`.
Нужен ли локальный EnergyPlus?
Нет, если сервер запущен в образе Docker: EnergyPlus 26.1.0 уже внутри. Для локальной разработки его ставят отдельно.
Можно ли править модель через агента?
Да. `modify_people`, `modify_lights` и `modify_electric_equipment` меняют нагрузки, `change_infiltration_by_mult` инфильтрацию, `add_window_film_outside` добавляет пленку на окна.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыOpenStudio MCP
openstudio-mcp
MCP-сервер для энергомоделирования зданий: агент строит модель OpenStudio, запускает EnergyPlus и разбирает результаты.
Локальный MCP-сервер Microsoft для семантических моделей Power BI: агент создает таблицы, меры DAX и связи в Power BI Desktop, Fabric и файлах PBIP
MCP-сервер и CLI для управления настоящим Microsoft Excel: Power Query, DAX, VBA, сводные таблицы, диаграммы
MCP-сервер с набором инструментов для сводок по миру: рынки, отчеты SEC, конфликты, климат и новости из открытых источников
Официальный MCP-сервер MathWorks: агент запускает и завершает MATLAB, пишет и выполняет код, проверяет его на ошибки и стиль
MCP-сервер от AntV для генерации графиков и диаграмм: 25 с лишним типов визуализаций, от линий и столбцов до карт, ментальных карт и диаграмм связей
Коротко о README
Сервер работает с IDF-файлами через стандартный интерфейс MCP. Клиентские примеры запускают его в Docker, а для разработки есть контейнер VS Code и локальная установка через `uv`.