Skip to main content
Glama
deenesjakoruzh
tuanank2112-crypto

revit-ai-native

by tuanank2112-crypto
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Autodesk Native Agent Runtime for Revit 2024

Производственный мост между ИИ-агентами (Antigravity, Claude и т.д.) и Autodesk Revit 2024, построенный на Model Context Protocol (MCP).

Архитектура

Antigravity / AI Agent
    ↓ (MCP over stdio)
MCP Server (TypeScript, Node.js)
    ↓ (Named Pipe, JSON envelopes)
Revit 2024 Add-in (.NET Framework 4.8)
    ↓ (ExternalEvent)
Main-thread Dispatcher → PlanExecutor
    ↓ (TransactionGroup)
Revit API (Document, Wall, FamilyInstance, ...)
    ↓ (Verification + Assertions)
Structured Result → MCP Response

Related MCP server: Revit MCP Server

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

1. Предварительные требования

  • Revit 2024 должен быть установлен (требуется для сборки надстройки)

  • .NET SDK (для сборки C#-проектов)

  • Node.js 18+ (для TypeScript-сервера MCP)

  • PowerShell (для скриптов сборки/установки)

2. Установите REVIT_2024_PATH

Если Revit установлен не в стандартное расположение (C:\Program Files\Autodesk\Revit 2024), задайте переменную окружения:

$env:REVIT_2024_PATH = "D:\REVIT\2024\Revit 2024"

3. Сборка

.\scripts\build-all.ps1

4. Установка надстройки

.\scripts\install-revit2024.ps1

5. Запустите Revit 2024

Откройте или создайте проект Revit. Надстройка автоматически запускает сервер именованных каналов.

6. Запустите MCP-сервер

.\scripts\start-mcp.ps1

7. Настройте Antigravity

Добавьте MCP-сервер в конфигурацию Antigravity:

{
  "mcpServers": {
    "revit": {
      "command": "node",
      "args": ["e:\\revit-A.I Native\\apps\\agent-mcp\\dist\\index.js"]
    }
  }
}

8. Получите статус

Вызовите revit_get_status от имени агента. Вы должны увидеть:

{
  "connected": true,
  "activeDocumentTitle": "YourProject.rvt",
  "busy": false
}

9. Предпросмотр плана

Отправьте план через revit_preview_plan:

{
  "schemaVersion": "1.0",
  "requestId": "test-001",
  "description": "Create a 5000mm wall",
  "document": { "strategy": "active_document" },
  "units": "mm",
  "coordinateSystem": "project",
  "executionMode": "preview",
  "operations": [...],
  "safety": { "requireUserConfirmation": true }
}

10. Подтверждение и фиксация

Вызовите revit_commit_plan с тем же планом. Если требуется подтверждение, подтвердите его в Revit.

11. Просмотр журнала аудита

Журналы аудита находятся в %LOCALAPPDATA%\AutodeskNativeAgent\logs в виде JSONL-файлов.

Поддерживаемые операции

Operation

Status

wall.create

✅ Поддерживается

wall.update

✅ Поддерживается

element.move

✅ Поддерживается

element.rotate

✅ Поддерживается

element.delete

✅ Поддерживается

element.rename

✅ Поддерживается

parameter.set

✅ Поддерживается

parameter.set_many

✅ Поддерживается

door.insert

✅ Поддерживается

window.insert

✅ Поддерживается

room.create

✅ Поддерживается

view.create_plan

✅ Поддерживается

sheet.create

✅ Поддерживается

sheet.place_view

✅ Поддерживается

document.save

✅ Поддерживается

document.save_as

✅ Поддерживается

export.pdf

✅ Поддерживается

export.dwg

✅ Поддерживается

Инструменты MCP

Tool

Описание

revit_get_status

Статус подключения и информация о документе

revit_get_capabilities

Версия протокола, методы, операции

revit_inspect_document

Идентификация активного документа

revit_inspect_selection

Текущее выделение

revit_query_elements

Структурированный запрос элементов

revit_validate_plan

Проверка без выполнения

revit_preview_plan

Предварительное разрешение (dry-run)

revit_commit_plan

Выполнение в транзакции

revit_get_job_status

Статус и результат задания

revit_cancel_job

Отмена задания в очереди/выполняющегося

revit_rollback_job

Откат завершённого задания

revit_get_audit_log

Очищенные записи аудита

Ключевые проектные решения

  1. Никаких вызовов Revit API из фоновых потоков — Все вызовы Revit API проходят через диспетчер ExternalEvent

  2. Атомарное выполнение — Планы выполняются внутри единой TransactionGroup; при сбоях происходит откат

  3. Структурированные ошибки — Каждый сбой содержит стабильный код ошибки

  4. Безопасность единиц измерения — Все длины имеют явные единицы; нет жёстко заданного / 304.8

  5. Безопасность типов — Разрешение типов/уровней детерминировано; нет случайного FirstElement()

  6. Безопасность путей — Пути экспорта/сохранения канонизируются и проверяются на обход каталогов

  7. Токены подтверждения — Деструктивные операции требуют одобрения человека

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

Лицензия

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • revit-mcp

    HoareLea
    A
    license
    A
    quality
    F
    maintenance
    Enables AI to interact with Revit via MCP, allowing data retrieval and element creation, modification, and deletion.
    13
    41 npm
    MIT

  • Horizun Revit MCP

    pablo-horizun
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Connects MCP clients like Claude, Codex, and Cursor to a running Autodesk Revit session for typed BIM queries, verified model edits, family authoring, exports, and Power BI workflows. It is open-source, Apache-2.0, and designed for reliable, verified outcomes.
    -