Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.
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-клиентами.
Начало работы | Примеры рабочих процессов | Инструменты | Документация | Скачать
AEC Model Bridge — это MCP-сервер для Revit с открытым исходным кодом: он позволяет Claude, Codex, Cursor и другим ИИ-ассистентам читать и редактировать открытую модель Revit, причём каждое изменение сначала согласуете вы. Он объединяет MCP-сервер на Python и нативный плагин для Revit: инструменты только для чтения сразу изучают модель, а изменения модели по умолчанию требуют согласованного плана. Как устроено согласование.
Настройка описана для Claude Desktop, VS Code с GitHub Copilot, Cursor и Codex. Это стандартный MCP-сервер со stdio, поэтому другие клиенты, такие как Claude Code, Windsurf, Cline, Continue, Zed и Gemini CLI, тоже должны работать. В разделе совместимость указано, что описано, а что не проверялось.
В тот же сервер входят проверка IFC, автоматизация Rhino и Grasshopper и интеграция со Speckle. В разделе Статус интеграций указано, какие провайдеры уже доступны, а какие ещё в разработке.
История звёзд
Примеры рабочих процессов
Для 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, описанные выше. Запланированные исправления и демо.
Быстрый старт
Установка в один клик
Кнопкам нужен только 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 с небольшим плагином внутри этого приложения.
Исходник диаграммы: architecture.mmd. Пересоздать изображения можно командой python scripts/render_diagrams.py.
Бирюзовые блоки работают уже сейчас. Янтарные блоки с пунктиром ещё в разработке. Индиго обозначает данные и внешние сервисы.
Как работает согласование
Хаб останавливает любой вызов инструмента, меняющий модель, если с ним не передан согласованный план. Режим по умолчанию — required. ИИ предлагает план, вы просматриваете его на боковой панели Revit, а плагин выполняет его в основном потоке 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.
Документация
- Руководство по установке
- Справочник инструментов
- Архитектура
- Справочник по конфигурации
- Безопасность
- MCP-клиенты и реестр
- Версионирование и релизы
- Вся документация
- Участие в проекте и Кодекс поведения
- Участники
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.
- Model Context Protocol Python SDK (MIT) for the MCP server
- IfcOpenShell (LGPL-3.0-or-later) for IFC files
- specklepy (Apache-2.0) for Speckle
- pydantic, httpx, NetworkX, openpyxl and PyYAML (MIT or BSD)
- Anthropic Python SDK (MIT) for the built-in agent chat
- Serilog, IronPython and Microsoft WebView2 in the Revit add-in
- Autodesk Revit and Navisworks and McNeel Rhino are separate products that you license yourself. This project does not include their code.
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 или коммерческая лицензия.