Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

36.7 KB
Raw Blame
Логотип AEC Model Bridge: изометрический куб модели с аркой моста

English | 简体中文 | Español | हिन्दी | العربية | Português (BR) | Русский | 日本語 | Deutsch | Français | Bahasa Indonesia | Türkçe | 한국어 | Tiếng Việt | Italiano | Polski | 繁體中文

Этот перевод выполнен с помощью ИИ. Основным источником остаётся английский README; исправления приветствуются через pull request (см. CONTRIBUTING.md).

Задавайте ИИ вопросы об открытой модели Revit. По умолчанию инструменты записи заблокированы, пока вы не согласуете план.

MCP-сервер с открытым исходным кодом и нативный плагин для Revit 2024 – 2027. Работает с Claude, Codex и другими MCP-клиентами.

CI Release Revit License

Начало работы | Примеры рабочих процессов | Инструменты | Документация | Скачать

Модель виллы в Revit рядом с панелью AEC Model Bridge с включённым режимом Dev.

AEC Model Bridge — это MCP-сервер для Revit с открытым исходным кодом: он позволяет Claude, Codex, Cursor и другим ИИ-ассистентам читать и редактировать открытую модель Revit, причём каждое изменение сначала согласуете вы. Он объединяет MCP-сервер на Python и нативный плагин для Revit: инструменты только для чтения сразу изучают модель, а изменения модели по умолчанию требуют согласованного плана. Как устроено согласование.

Работает с: для Claude Desktop, VS Code с GitHub Copilot, Cursor и Codex есть описанная настройка. Другие MCP-клиенты, такие как Claude Code, Windsurf, Cline, Continue, Zed и Gemini CLI, тоже должны работать. Приложения: Revit 2024–2027, Rhino, Grasshopper, Navisworks (в разработке). Данные: IFC, Speckle, Excel, SQLite. Протокол: MCP через stdio со шлюзом согласования.

Настройка описана для Claude Desktop, VS Code с GitHub Copilot, Cursor и Codex. Это стандартный MCP-сервер со stdio, поэтому другие клиенты, такие как Claude Code, Windsurf, Cline, Continue, Zed и Gemini CLI, тоже должны работать. В разделе совместимость указано, что описано, а что не проверялось.

В тот же сервер входят проверка IFC, автоматизация Rhino и Grasshopper и интеграция со Speckle. В разделе Статус интеграций указано, какие провайдеры уже доступны, а какие ещё в разработке.

История звёзд

Star History Chart

Примеры рабочих процессов

Для BIM-координаторов: проверить качество модели, просмотреть затронутые элементы, согласовать исправление параметров, затем проверить результат и выгрузить отчёт. В примерах используются инструменты из текущего каталога.

Процесс Пример запроса Используемые инструменты
Проверка модели "Покажи активный документ, перечисли предупреждения и найди затронутые элементы." revit_get_document_info, revit_get_warnings, revit_get_elements_by_type
Обновление параметров "Найди стены на уровне Level 02, покажи значения Comments и предложи пакетное обновление." revit_get_elements_by_type, revit_get_element_parameters, revit_batch_set_parameters
Выпуск чертежей "Подготовь список листов из этого CSV, затем предложи создать листы и разместить виды." revit_batch_create_sheets_from_csv, revit_place_viewport_on_sheet
Проверка IFC "Покажи этажи этого IFC-файла, изучи свойства стен и сообщи о проблемах проверки схемы." ifc_get_spatial_structure, ifc_get_properties, ifc_validate

Для первого запуска в Revit попробуйте:

Read the active model's warnings. Group them by description and show the
affected element IDs. Then suggest which issues to investigate first.

Затем попробуйте исправить параметр, подставив уровень и значение из вашего проекта:

Find walls on Level 02 and show their current Comments values. Propose setting
Comments to "Coordination reviewed" for the elements I choose. After I approve
the plan in Revit, apply it and read the values back to confirm the result.

Для правок ассистент составляет план через plan_actions; вы просматриваете его на панели Revit, и только потом execute_plan его применяет. Проверка IFC работает без Revit.

Модули QA/QC и отчётов на основе снимков (snapshot) требуют совместимого сохранённого снимка. Сейчас передача снимка из Revit в модуль требует, чтобы совпадали имя файла и рабочая папка; если не указать snapshot_id, могут вернуться сгенерированные демонстрационные данные. Для проверки открытой модели используйте прямые инструменты Revit, описанные выше. Запланированные исправления и демо.

Быстрый старт

Установка в один клик

Install in VS Code Install in Cursor Claude Desktop bundle

Кнопкам нужен только uv, другая настройка не требуется: сервер использует ~/Documents/AEC Model Bridge как рабочую папку, если вы не задали свою. Для Claude Desktop скачайте файл .mcpb из последнего релиза и откройте его. Для работы в запущенном Revit по-прежнему нужны Revit и плагин; режиму mock ничего не нужно.

Ручная настройка

Для автоматизации запущенного Revit нужны Windows, лицензионный Revit 2024–2027, Python 3.11 или новее, uv и плагин Revit (шаги установки). Затем добавьте это в claude_desktop_config.json (Codex, Cursor и VS Code используют те же значения; две переменные с каталогами необязательны, по умолчанию берётся рабочая папка, указанная выше):

{
  "mcpServers": {
    "aec-model-bridge": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Sam-AEC/aec-model-bridge#subdirectory=packages/mcp-server-revit",
        "aec-model-bridge"
      ],
      "env": {
        "MCP_REVIT_MODE": "bridge",
        "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
        "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
      }
    }
  }
}

Хотите сначала посмотреть инструменты без Revit? Задайте "MCP_REVIT_MODE": "mock". Сервер запустится где угодно, покажет все инструменты со схемами и будет возвращать готовые ответы, не трогая модель. Dockerfile для такого же режима mock лежит в корне репозитория (docker build -t aec-model-bridge ., затем docker run -i --rm aec-model-bridge).

Используете VS Code? Исходный код расширения и шаги локальной установки регистрируют MCP-сервер и показывают состояние подключения к Revit. В Marketplace расширение не опубликовано.

Инструменты вкратце

Область Инструменты Что делают
Revit 103 Чтение модели, создание и правка элементов, параметров, видов, листов, спецификаций, экспорт, совместная работа
Согласование 6 Планирование, проверка, согласование, выполнение и откат изменений модели
Модули 34 Анализ снимков, таблицы параметров, проверки QA/QC, рецепты, отчёты, выборки
Rhino и Grasshopper 19 Геометрия, слои, материалы, булевы операции
Speckle 17 Проекты, модели, версии, отправка и получение
Navisworks 15 Дерево модели, точки обзора, проверка коллизий (в разработке)
IFC 7 Чтение IFC-файлов без Revit: структура, свойства, проверка
Граф, снимки, экспорт, задания 18 Аудит семантического графа, сравнение снимков, экспорт в SQLite, фоновые задания

В конфигурации по умолчанию доступно 219 инструментов (подсчитано на текущем сервере в режиме mock). Инструменты Autodesk Data появляются, когда настроены учётные данные APS. В справочнике инструментов перечислены все инструменты. У каждого инструмента есть аннотации MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), по которым клиенты отличают чтение от записи.

Расширенная автоматизация Revit

Помимо запросов к модели и обновления параметров, инструменты Revit создают строительные элементы, виды, листы, спецификации, марки и размеры, а также экспортируют файлы IFC, DWG, изображения и Navisworks. Поддерживаемые операции и входные данные описаны в справочнике инструментов.

Для задач, которых нет в каталоге, revit_invoke_method, revit_reflect_get и revit_reflect_set работают с открытыми членами Revit API, а revit_execute_python запускает IronPython внутри Revit. У этих инструментов те же права, что и у процесса Revit. Используйте их только с MCP-клиентами и промптами, которым доверяете.

Как это работает

MCP-клиент обращается к одному Python-хабу. Хаб передаёт каждый вызов провайдеру, которому принадлежит инструмент. Провайдеры для настольных приложений общаются по localhost с небольшим плагином внутри этого приложения.

Архитектура AEC Model Bridge: MCP-клиент, например Claude или Codex, обращается к Python-хабу MCP, который направляет вызовы инструментов провайдерам Revit, Rhino, Navisworks, IFC и Speckle. Провайдеры Revit и Rhino общаются с плагинами по HTTP через localhost, провайдер IFC читает файлы IFC с помощью IfcOpenShell, а Navisworks пока в разработке.

Исходник диаграммы: architecture.mmd. Пересоздать изображения можно командой python scripts/render_diagrams.py.

Бирюзовые блоки работают уже сейчас. Янтарные блоки с пунктиром ещё в разработке. Индиго обозначает данные и внешние сервисы.

Как работает согласование

Хаб останавливает любой вызов инструмента, меняющий модель, если с ним не передан согласованный план. Режим по умолчанию — required. ИИ предлагает план, вы просматриваете его на боковой панели Revit, а плагин выполняет его в основном потоке Revit, действия с параметрами и правки модели выполняются каждое в своей именованной транзакции; сохранение, синхронизация и скрипты — нет, поэтому Ctrl+Z их не охватывает.

Проверить, предложить, согласовать, сверить. Четыре шага: проверка находит пустое значение Mark, предложение составляет изменение, согласование — решение человека, сверка считывает значение обратно. Значения приведены для примера.

Схема согласования: ИИ-ассистент составляет план через plan_actions, боковая панель показывает предлагаемые изменения (количество, область, значения до и после), а человек согласует их в панели или через CLI aec-model-bridge-approve, но никогда через MCP. Хаб проверяет, что план совпадает с согласованным инструментом и аргументами, и только один раз. Затем Revit выполняет каждое действие в отдельной транзакции, поэтому Ctrl+Z отменяет одно действие за нажатие. Если вы отклонили план или не согласовали его, вызов блокируется, а модель остаётся нетронутой.

Исходник диаграммы: approval-flow.mmd. Пересоздать изображения можно командой python scripts/render_diagrams.py.

Если план оказался ошибочным, отмените его сочетанием Ctrl+Z в Revit. Каждая запись параметра — отдельная именованная транзакция, поэтому для одного плана может потребоваться несколько нажатий. Отмена всего плана одним шагом запланирована, но пока не реализована. Второй путь — план отката: ассистент составляет его командой plan_revert по подтверждению выполненного плана, а вы утверждаете его как любой другой план. rollback_plan предназначен только для людей и не является ни кнопкой, ни командой, поэтому не рассчитывайте на него. Ни один из этих путей пока не проверен в реальном сеансе Revit (UNVERIFIED). Операции, которые нельзя отменить, например запись файлов, не отменяются ни одним из них и пока не требуют повторного подтверждения (запланировано). Список Plans на панели показывает только ожидающие планы; aec-model-bridge-approve show <plan_id> работает для плана в любом состоянии, а пакеты proofs/ существуют только для планов, которые были выполнены (или предприняты попытки выполнения). Жизненный цикл описан в ADR 0008.

Для конвейеров без участия человека можно задать MCP_REVIT_APPROVAL_MODE=auto. Это отключает проверку человеком, поэтому используйте режим только в контролируемой среде.

Поддерживаемые версии Revit

Версия Revit Целевая платформа плагина Средства сборки
2024 .NET Framework 4.8 .NET 8 SDK и пакет разработчика .NET Framework 4.8
2025 .NET 8 for Windows .NET 8 SDK
2026 .NET 8 for Windows .NET 8 SDK
2027 .NET 10 for Windows .NET 10 SDK

Также нужны Windows 10 или 11, Python 3.11 или новее и лицензионная установка нужной версии Revit. Режим mock запускает сервер без Revit, что удобно для разработки и тестов.

Другие интеграции

Интеграция Статус
Revit Доступно. Нативный плагин на C#.
IFC (IfcOpenShell) Доступно. Читает IFC-файлы без запущенного Revit.
Rhino и Grasshopper Доступно. Подключается к плагину Rhino на localhost:3004.
Speckle Доступно. Нужен идентификатор клиента Speckle в вашей среде.
Navisworks Manage В разработке. Провайдер и его инструменты зарегистрированы. Плагин для Navisworks не завершён.
Power BI В разработке. Провайдер и инструмент есть, но не зарегистрированы в хабе.
Excel, Parquet и DuckDB Запланировано.

Названия продуктов и логотипы принадлежат их владельцам. Баннер использует их только для того, чтобы показать, с чем работает этот проект.

Установка плагина Revit

Проще всего (Windows): скачайте AECModelBridge-Setup-<version>.exe из последнего релиза, запустите его двойным щелчком, выберите версии Revit и перезапустите Revit. Он установит плагин, входящий в комплект сервер Python и, если отметить галочку, настройки Claude Desktop и VS Code с резервной копией текущих настроек. Удалить программу можно в параметрах Windows. Шаги ниже нужны для сборки из исходников.

Устанавливаются две части: MCP-сервер на Python и плагин Revit. Для работы с запущенным Revit нужны обе.

1. Установка MCP-сервера

git clone https://github.com/Sam-AEC/aec-model-bridge.git
cd aec-model-bridge

py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e packages/mcp-server-revit

2. Установка плагина Revit

Укажите версию, соответствующую вашей установке Revit. Если Windows блокирует скачанные скрипты, щёлкните каждый файл .ps1 правой кнопкой, откройте «Свойства» и перед запуском выберите «Разблокировать».

$RevitVersion = Read-Host "Revit year (2024, 2025, 2026, or 2027)"

.\scripts\package.ps1 -RevitVersion $RevitVersion
.\scripts\install.ps1 -RevitVersion $RevitVersion

Установщик помещает бинарные файлы для каждой версии в:

C:\ProgramData\AECModelBridge\bin\<year>

Манифест плагина устанавливается для текущего пользователя в:

%APPDATA%\Autodesk\Revit\Addins\<year>

Добавьте -AllUsers к install.ps1, чтобы вместо этого установить манифест в C:\ProgramData\Autodesk\Revit\Addins\<year>.

Чтобы подготовить бинарные файлы сразу для всех поддерживаемых версий:

.\scripts\package.ps1 -RevitVersion All

В каждом релизе на GitHub есть готовый пакет для каждого года Revit, например aec-model-bridge-revit-2026-<version>.zip. Распакуйте его и выполните .\install.ps1 -RevitVersion 2026 вместо сборки из исходников. Установщик Windows с запуском двойным щелчком собирается скриптом scripts/build-installer.ps1 с помощью Inno Setup. Полное руководство с разбором неполадок — в docs/install.md.

Подключение Claude Desktop к Revit

Добавьте сервер в конфигурацию MCP-клиента. В Claude Desktop это раздел mcpServers файла claude_desktop_config.json. Codex, Cursor, VS Code и другие MCP-клиенты используют те же значения command, args и env в своём формате конфигурации.

Используйте исполняемый файл Python из вашего виртуального окружения и выберите рабочую папку, к которой серверу разрешён доступ:

{
  "mcpServers": {
    "aec-model-bridge": {
      "command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
      "args": ["-m", "revit_mcp_server.mcp_server"],
      "env": {
        "MCP_REVIT_MODE": "bridge",
        "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
        "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
      }
    },
    "aec-model-bridge-revit-2026": {
      "command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
      "args": ["-m", "revit_mcp_server.mcp_server"],
      "env": {
        "MCP_REVIT_MODE": "bridge",
        "MCP_REVIT_HOST_VERSION": "2026",
        "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
        "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
      }
    }
  }
}

Если не указывать MCP_REVIT_HOST_VERSION, будет выбран самый новый из открытых экземпляров Revit. Задайте год, например 2024 или 2026, чтобы закрепить запись клиента за этой версией Revit. MCP_REVIT_BRIDGE_URL переопределяет адрес в сложных конфигурациях.

Пользователи VS Code могут взять за основу .vscode/mcp.json. Пользователи Hermes Desktop могут взять docs/examples/hermes-desktop.json, заменив путь-заполнитель к Python. Клиенты с поддержкой MCP Bundles могут установить файл .mcpb из последнего релиза. Плагин Revit по-прежнему обязателен, потому что сервер обращается к запущенному настольному приложению.

Проверка подключения

Перезапустите Revit после установки плагина, откройте модель и выполните:

$registry = Get-ChildItem "$env:LOCALAPPDATA\AECModelBridge\registry\revit-*.json" | Select-Object -First 1
$switch = Get-Content $registry.FullName -Raw | ConvertFrom-Json
Invoke-RestMethod "$($switch.endpoint)/health"

В ответе должны быть healthy и версия запущенного Revit. В Revit найдите вкладку ленты AEC Bridge. На панели Workflows есть Open Panel, Health Check, Pending Actions и Reports. На панели Tools — Config, Help и About.

Безопасность

  • Мост Revit слушает только localhost.
  • Сервер читает и записывает данные только в папках из MCP_REVIT_ALLOWED_DIRECTORIES.
  • Инструментам, изменяющим модель, нужен согласованный план, если вы не отключили согласование.
  • Вызовы инструментов записываются в журнал аудита, секреты скрываются.

Подробности — в docs/security.md. О найденной уязвимости сообщайте по правилам из SECURITY.md.

Вопросы и ответы

Что такое MCP-сервер для Revit?

Model Context Protocol (MCP) — открытый стандарт, позволяющий ИИ-ассистентам вызывать инструменты в другом ПО. MCP-сервер для Revit предоставляет операции Revit в виде инструментов. Ассистент выбирает инструменты, а плагин выполняет их внутри Revit.

С какими ИИ-ассистентами это работает?

С любым MCP-клиентом, который умеет запускать локальный stdio-сервер. Мы документируем Claude Desktop, VS Code с GitHub Copilot, Cursor и Codex, а также клиенты, читающие стандартную конфигурацию mcpServers. Windsurf, Cline, Roo Code, Continue, Zed, Claude Code и Gemini CLI должны работать так же, но не проверялись. См. совместимость. Чат на панели может также использовать ключ Anthropic API или консольные утилиты claude и codex, если они установлены. См. ADR 0012.

Может ли ИИ изменить мою модель без спроса?

В режиме по умолчанию нет. Инструменты, меняющие модель, блокируются, пока план не согласован на панели Revit. Инструменты только для чтения работают без согласования. Если задать MCP_REVIT_APPROVAL_MODE=auto, согласование пропускается.

Отправляется ли моя модель в облако?

Сервер и плагин работают на вашем компьютере, а мост слушает только localhost. Что увидит ИИ-ассистент, зависит от используемого клиента: результаты инструментов отправляются провайдеру модели этого клиента. Облачные провайдеры, такие как Speckle, работают только тогда, когда вы их настроили и вызвали их инструменты.

Работает ли это с IFC-файлами без Revit?

Да. Провайдер IFC читает файлы через IfcOpenShell. Он возвращает метаданные файла, пространственную структуру, свойства элементов и габаритные рамки, выполняет запросы по классу, GUID, имени или свойству и проверяет схему. Редактировать IFC-файлы он не умеет.

Можно ли использовать без установленного Revit?

Сервер можно запускать в режиме mock для разработки и тестов. Для работы с открытой моделью нужны Revit 2024–2027 и плагин.

Релизы и версии

AEC Model Bridge следует семантическому версионированию. Релизы помечаются тегами vX.Y.Z на GitHub, а номер версии хранится в файле VERSION в корне. Процесс выпуска описан в docs/versioning.md, изменения каждой версии — в CHANGELOG.md.

Разработка

# Python tests
python -m pytest packages/mcp-server-revit/tests

# Build one Revit version, for example 2026
.\scripts\build-addin.ps1 -RevitVersion 2026 -Configuration Release

# Build all supported versions
.\scripts\package.ps1 -RevitVersion All

CI собирает Python-сервер и целевые сборки плагина для Revit 2024–2027. Перед созданием pull request прочитайте CONTRIBUTING.md.

Документация

Built with

AEC Model Bridge stands on open-source work. It is independent and is not affiliated with or endorsed by any project named here.

Licence texts and the full list of packages are in THIRD_PARTY_NOTICES.md. Licences were read from package metadata; rows that could not be verified are marked as such.

Проект и лицензия

Поддерживает A. Sam Mohammad. LinkedIn | Issues

GPL-3.0-or-later с исключением Revit Linking Exception или коммерческая лицензия.