Skip to main content
Glama

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

Operation

Status

wall.create

✅ Unterstützt

wall.update

✅ Unterstützt

element.move

✅ Unterstützt

element.rotate

✅ Unterstützt

element.delete

✅ Unterstützt

element.rename

✅ Unterstützt

parameter.set

✅ Unterstützt

parameter.set_many

✅ Unterstützt

door.insert

✅ Unterstützt

window.insert

✅ Unterstützt

room.create

✅ Unterstützt

view.create_plan

✅ Unterstützt

sheet.create

✅ Unterstützt

sheet.place_view

✅ Unterstützt

document.save

✅ Unterstützt

document.save_as

✅ Unterstützt

export.pdf

✅ Unterstützt

export.dwg

✅ Unterstützt

MCP-Tools

Tool

Beschreibung

revit_get_status

Verbindungsstatus und Dokumentinformationen

revit_get_capabilities

Protokollversion, Methoden, Operationen

revit_inspect_document

Identität des aktiven Dokuments

revit_inspect_selection

Aktuelle Auswahl

revit_query_elements

Strukturierte Elementabfrage

revit_validte_plan

Ohne Ausführung validieren

revit_preview_plan

Trockenlauf-Auflösung

revit_commit_plan

In einer Transaktion ausführen

revit_get_job_status

Auftragsstatus und Ergebnis

revit_cancel_job

Eingereihten/laufenden Auftrag abbrechen

revit_rollback_job

Abgeschlossenen Auftrag zurücsetzen

revit_get_audit_log

Bereinigte Audit-Einträge

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

Lizenz

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers