OpenStudio MCP
openstudio-mcp
MCP-сервер для энергомоделирования зданий: агент строит модель OpenStudio, запускает EnergyPlus и разбирает результаты.
- 57 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент пишет и запускает меры на Ruby и Python, а файлы создаются в смонтированных папках.
- Код мер идет в песочнице, но на macOS и Windows без Docker действует только фильтр окружения.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/openstudio-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент пишет и запускает меры на Ruby и Python, а файлы создаются в смонтированных папках.
- Код мер идет в песочнице, но на macOS и Windows без Docker действует только фильтр окружения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает OpenStudio и EnergyPlus в более 150 MCP-инструментов. Агент создает здание по планам, задает системы отопления и вентиляции, меняет утепление и остекление, запускает годовой расчет и читает результаты: удельное энергопотребление, часы недогрева, отчеты HTML. Модель можно править готовыми «мерами». Агент пишет меру на Ruby или Python, проверяет ее, применяет и сравнивает показатели до и после. Сервер запускается в контейнере Docker, а код мер идет в отдельной песочнице. Для общего сервера есть режим HTTP с изолированными сессиями и токенами.
Для кого. Энергомоделистам и инженерам по ОВК, которые считают энергопотребление зданий в OpenStudio и хотят сократить ручную сборку моделей.
Подходит, если
- Офис на десять зон надо собрать с VAV-системой и сразу прогнать за год.
- Сравниваются два варианта ОВК, например VAV и тепловые насосы VRF, по энергопотреблению.
- Модель из gbXML импортируется и проверяется перед расчетом.
- Мера из локальной папки применяется к модели, а эффект виден в сводке показателей.
Не подходит, если
- Расчет нужен в другой программе: сервер работает только с OpenStudio и EnergyPlus.
- Docker на машине не установлен и ставить его нельзя.
- Меры берутся из недоверенных источников без изоляции: на macOS и Windows без Docker песочницы нет.
Пример запроса к агенту
Создай офис на десять зон с VAV-системой и подогревом, запусти годовой расчет и покажи удельное энергопотребление.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
OPENSTUDIO_MCP_MODE- Режим запуска, в примере из README задан `prod`.
MCP_TRANSPORT- Значение `http` включает общий сервер для нескольких пользователей вместо stdio.
OSMCP_SANDBOX- Уровень изоляции кода мер: `auto` по умолчанию, `off` отключает изоляцию.
Ограничения
Быстрый старт требует запущенный Docker Desktop. Агент видит только файлы из смонтированных папок: модели лежат в `/inputs`, результаты пишутся в `/runs`, меры в `/measures`. Меры OpenStudio — это Ruby или Python, их код считается недоверенным. Песочница Landlock и seccomp работает на Linux и в виртуальной машине Docker Desktop. Исходники лицензированы по LICENSE.txt, GitHub тип лицензии не определил.
Как отключить. Удалите запись `openstudio-mcp` из конфигурации клиента. Образ убирает команда `docker rmi nrel/openstudio-mcp:v1.2.1`, а результаты расчетов остаются в папке `/runs` на хосте.
Частые вопросы
Как подключить OpenStudio MCP к Claude Code?
Скачайте образ командой `docker pull nrel/openstudio-mcp:v1.2.1` и добавьте в `.mcp.json` запуск `docker run --rm -i` с тремя монтированиями и переменной `OPENSTUDIO_MCP_MODE=prod`. В README Claude Code помечен как полностью поддерживаемый клиент.
Почему агент не открывает прикрепленный файл модели?
Вложение попадает в чат, но не на диск контейнера. Положите файл в папку, смонтированную как `/inputs`, и в запросе укажите `/inputs/имя-файла`.
Где лежат результаты расчета?
В папке, смонтированной как `/runs`, в подпапке `/runs/<run_id>/`: модель OSM, база SQL и отчеты HTML. Без монтирования результаты исчезают при выходе из контейнера.
Безопасно ли запускать чужие меры?
Код мер считается недоверенным. По умолчанию он идет от непривилегированного пользователя, без сети и с ограничением файловой системы. Режим `OSMCP_SANDBOX=off` отключает защиту и подходит только для своего кода.
Можно ли запретить агенту писать код?
Да. Переменная `OSMCP_ENABLE_CODE_TOOLS=false` убирает инструменты `create_measure`, `edit_measure`, `create_python_plugin`, `edit_python_plugin` и `install_plugin_packages`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер из 35 инструментов для энергомоделей зданий EnergyPlus: загрузка IDF, правка параметров, расчет и графики.
MCP-сервер от проекта OpenSearch открывает агенту кластер: индексы, маппинги, поиск по DSL и состояние шардов.
MCP-сервер, который дает агенту запускать локальный Stata: регрессии, эконометрика, воспроизведение расчетов из статей
MCP-сервер с набором инструментов для сводок по миру: рынки, отчеты SEC, конфликты, климат и новости из открытых источников
Официальный MCP-сервер MathWorks: агент запускает и завершает MATLAB, пишет и выполняет код, проверяет его на ошибки и стиль
Официальный MCP-сервер Data Commons: агент ищет статистические показатели и тянет наблюдения по странам, регионам и городам.
Коротко о README
Быстрый старт идет через Docker для Claude Desktop и Codex, режим HTTP для команд, песочницу для кода мер и справочники по системам ОВК. Проект опубликован в журнале SoftwareX, в репозитории есть более 500 интеграционных тестов.