revit-ai-native
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 ResponseRelated 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.ps14. Add-in installieren
.\scripts\install-revit2024.ps15. 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.ps17. 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 |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
| ✅ Unterstützt |
MCP-Tools
Tool | Beschreibung |
| Verbindungsstatus und Dokumentinformationen |
| Protokollversion, Methoden, Operationen |
| Identität des aktiven Dokuments |
| Aktuelle Auswahl |
| Strukturierte Elementabfrage |
| Ohne Ausführung validieren |
| Trockenlauf-Auflösung |
| In einer Transaktion ausführen |
| Auftragsstatus und Ergebnis |
| Eingereihten/laufenden Auftrag abbrechen |
| Abgeschlossenen Auftrag zurücsetzen |
| Bereinigte Audit-Einträge |
Wichtige Designentscheidungen
Keine Revit-API aus Hintergrundthreads — Alle Revit-API-Aufrufe erfolgen über den ExternalEvent-Dispatcher
Atomare Ausführung — Pläne laufen innerhalb einer einzelnen TransactionGroup; Fehlschläge werden zurückgerollt
Strukturierte Fehler — Jeder Fehler trägt einen stabilen Fehlercode
Einheitensicherheit — Alle Längen tragen explizite Einheiten; kein hartkodiertes
/ 304.8Typsicherheit — Typ-/Ebenenauflösung ist deterministisch; kein zufälliges
FirstElement()Pfadsicherheit — Export-/SaveAs-Pfade werden kanonisiert und auf Traversal geprüft
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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read and edit the Revit 2024–2027 model on your PC. Needs the free Revit MCP add-in.
AI for Revit: 450+ tools, 1 undo step. Windows, Revit 2024–2027 (2021–2023 included). Free account.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Related MCP Servers
- AlicenseAqualityFmaintenanceAllows AI to interact with Autodesk Revit via the MCP protocol, enabling retrieval of project data and automation of tasks like creating, modifying, and deleting elements.13482MIT
- AlicenseBqualityNot gradedmaintenanceAllows AI assistants to interact with Autodesk Revit through the MCP protocol, enabling the AI to create, modify, and delete elements in Revit projects.1559 npm1-
- AlicenseAqualityFmaintenanceEnables AI to interact with Revit via MCP, allowing data retrieval and element creation, modification, and deletion.13MIT
- AlicenseBqualityCmaintenanceEnables AI agents to connect to Autodesk Revit and run Revit API Python, inspect models, capture screenshots, request user element selections or annotated snips, and manage multi-instance connections through MCP.13MIT