Autodesk Native Agent Runtime for Revit 2024

Eine produktionsreife Brücke zwischen KI-Agenten (Antigravity, Claude usw.) und Autodesk Revit 2024, die auf dem Model Context Protocol (MCP) basiert.

Architektur

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

Schnellstart

1. Voraussetzungen

• Revit 2024 installiert (für den Add-in-Build erforderlich)

• . NET SDK (zum Erstellen von C#-Projekten)

• Node.js 18+ (für den MCP-TypeScript-Server)

• PowerShell (für Build-/Installationsskripte)

2. REVIT_2024_PATH festlegen

Falls Revit nicht am Standardort (C:\Program Files\Autodesk\Revit 2024) installiert ist, legen Sie die Umgebungsvariable fest:

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

3. Erstellen

.\scripts\build-all.ps1

4. Add-in installieren

.\scripts\install-revit2024.ps1

5. Revit 2024 öffnen

Öffnen oder erstellen Sie ein Revit-Projekt. Das Add-in startet den Named-Pipe-Server automatisch.

6. MCP-Server starten

.\scripts\start-mcp.ps1

7. Antigravity konfigurieren

Fügen Sie den MCP-Server zu Ihrer Antigravity-Konfiguration hinzu:

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

8. Status abrufen

Rufen Sie revit_get_status von Ihrem Agenten auf. Sie sollten Folgendes sehen:

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

9. Planvorschau anzeigen

Senden Sie einen Plan an 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. Genehmigen und committen

Rufen Sie revit_commit_plan mit demselben Plan auf. Falls eine Bestätigung erforderlich ist, genehmigen Sie in Revit.

11. Audit-Protokoll prüfen

Audit-Protokolle befinden sich als JSONL-Dateien unter %LOCALAPPDATA%\AutodeskNativeAgent\logs.

Unterstützte Operationen

MCP-Tools

Wichtige Designentscheidungen

1. Keine Revit-API aus Hintergrundthreads — Alle Revit-API-Aufrufe erfolgen über den ExternalEvent-Dispatcher

2. Atomare Ausführung — Pläne laufen innerhalb einer einzelnen TransactionGroup; Fehlschläge werden zurückgerollt

3. Strukturierte Fehler — Jeder Fehler trägt einen stabilen Fehlercode

4. Einheitensicherheit — Alle Längen tragen explizite Einheiten; kein hartkodiertes / 304.8

5. Typsicherheit — Typ-/Ebenenauflösung ist deterministisch; kein zufälliges FirstElement()

6. Pfadsicherheit — Export-/SaveAs-Pfade werden kanonisiert und auf Traversal geprüft

7. Bestätigungstokens — Destruktive Operationen erfordern eine menschliche Genehmigung

Dokumentation

• Architektur

• Sicherheit

• Befehle

• Fehlerbehebung

• Entwicklung mit Revit 2024

• Erweiterung für Autodesk

• Manuelle Testcheckliste

Lizenz

MIT