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-файлов.

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

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

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

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

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

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

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

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

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

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

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

• Архитектура

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

• Команды

• Устранение неполадок

• Разработка для Revit 2024

• Расширение для AutoCAD

• Контрольный список ручного тестирования

Лицензия

MIT