Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.
English | 简体中文 | Español | हिन्दी | العربية | Português (BR) | Русский | 日本語 | Deutsch | Français | Bahasa Indonesia | Türkçe | 한국어 | Tiếng Việt | Italiano | Polski | 繁體中文
Diese Übersetzung wurde mit KI-Unterstützung erstellt. Maßgeblich ist die englische README; Korrekturen sind per Pull Request willkommen (siehe CONTRIBUTING.md).
Fragen Sie Ihre KI zum geöffneten Revit-Modell. Standardmäßig sind Schreibwerkzeuge gesperrt, bis Sie einen Plan freigeben.
Open-Source-MCP-Server und natives Add-in für Revit 2024 – 2027. Funktioniert mit Claude, Codex und anderen MCP-Clients.
Erste Schritte | Beispiel-Workflows | Werkzeuge | Dokumentation | Download
AEC Model Bridge ist der Open-Source-Revit-MCP-Server, mit dem Claude, Codex, Cursor und andere KI-Assistenten Ihr geöffnetes Revit-Modell lesen und bearbeiten können – jede Änderung erst nach Ihrer Freigabe. Er kombiniert einen MCP-Server in Python mit einem nativen Revit-Add-in: Schreibgeschützte Werkzeuge untersuchen das Modell sofort, und Änderungen am Modell erfordern standardmäßig einen freigegebenen Plan. So funktioniert die Freigabe.
Die Einrichtung ist für Claude Desktop, VS Code mit GitHub Copilot, Cursor und Codex dokumentiert. Es handelt sich um einen Standard-MCP-Server über stdio, daher sollten auch andere Clients wie Claude Code, Windsurf, Cline, Continue, Zed und Gemini CLI funktionieren. Was dokumentiert und was ungetestet ist, steht unter Kompatibilität.
Derselbe Server enthält außerdem IFC-Prüfung, Rhino- und Grasshopper-Automatisierung sowie die Speckle-Anbindung. Der Status der Integrationen trennt verfügbare Provider von solchen, die noch in Arbeit sind.
Sterneverlauf
Beispiel-Workflows
Für BIM-Koordinatoren: Modellqualität prüfen, betroffene Elemente ansehen, eine Parameterkorrektur freigeben, dann das Ergebnis kontrollieren und einen Bericht exportieren. Die Beispiele nutzen Werkzeuge aus dem aktuellen Katalog.
| Workflow | Beispielanfrage | Verwendete Werkzeuge |
|---|---|---|
| Modellprüfung | "Zeige das aktive Dokument, liste die Warnungen auf und finde die betroffenen Elemente." | revit_get_document_info, revit_get_warnings, revit_get_elements_by_type |
| Parameteraktualisierung | "Finde die Wände auf Level 02, zeige ihre Comments-Werte und schlage eine Stapelaktualisierung vor." | revit_get_elements_by_type, revit_get_element_parameters, revit_batch_set_parameters |
| Planerstellung | "Erstelle aus dieser CSV eine Planliste und schlage vor, die Pläne anzulegen und die Ansichten zu platzieren." | revit_batch_create_sheets_from_csv, revit_place_viewport_on_sheet |
| IFC-Prüfung | "Zeige die Geschosse dieser IFC-Datei, prüfe die Wandeigenschaften und melde Probleme bei der Schemavalidierung." | ifc_get_spatial_structure, ifc_get_properties, ifc_validate |
Für einen ersten Versuch in Revit probieren Sie:
Read the active model's warnings. Group them by description and show the
affected element IDs. Then suggest which issues to investigate first.
Probieren Sie dann eine Parameterkorrektur und ersetzen Sie Ebene und Wert durch die Angaben Ihres Projekts:
Find walls on Level 02 and show their current Comments values. Propose setting
Comments to "Coordination reviewed" for the elements I choose. After I approve
the plan in Revit, apply it and read the values back to confirm the result.
Für Änderungen erstellt der Assistent mit plan_actions einen Plan; Sie prüfen ihn im Revit-Panel, bevor execute_plan ihn anwendet. Die IFC-Prüfung läuft ohne Revit.
Die Snapshot-basierten QA/QC- und Berichtsmodule benötigen einen kompatiblen gespeicherten Snapshot. Die aktuelle Übergabe des Snapshots von Revit an das Modul erfordert übereinstimmenden Dateinamen und Arbeitsbereich; ohne snapshot_id können generierte Beispieldaten zurückkommen. Für die Live-Prüfung nutzen Sie die direkten Revit-Werkzeuge oben. Geplante Korrekturen und Demo.
Schnellstart
Installation mit einem Klick
Die Schaltflächen benötigen nur uv und sonst keine Einrichtung: Der Server verwendet ~/Documents/AEC Model Bridge als Arbeitsbereich, sofern Sie keinen eigenen festlegen. Für Claude Desktop laden Sie die .mcpb-Datei aus dem neuesten Release herunter und öffnen sie. Für die Arbeit mit einem laufenden Revit brauchen Sie weiterhin Revit und das Add-in; der Mock-Modus braucht nichts davon.
Manuelle Einrichtung
Für die Live-Automatisierung von Revit benötigen Sie Windows, ein lizenziertes Revit 2024 bis 2027, Python 3.11 oder neuer, uv und das Revit-Add-in (Installationsschritte). Fügen Sie dann Folgendes in Ihre claude_desktop_config.json ein (Codex, Cursor und VS Code verwenden dieselben Werte; die beiden Verzeichnisvariablen sind optional und verweisen standardmäßig auf den oben genannten Arbeitsbereich):
{
"mcpServers": {
"aec-model-bridge": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Sam-AEC/aec-model-bridge#subdirectory=packages/mcp-server-revit",
"aec-model-bridge"
],
"env": {
"MCP_REVIT_MODE": "bridge",
"MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
"MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
}
}
}
}
Möchten Sie die Werkzeuge zuerst ohne Revit ansehen? Setzen Sie "MCP_REVIT_MODE": "mock". Der Server startet dann überall, listet jedes Werkzeug mit seinem Schema auf und liefert vorgefertigte Antworten, ohne ein Modell anzufassen. Ein Dockerfile für denselben Mock-Modus liegt im Repository-Stammverzeichnis (docker build -t aec-model-bridge ., dann docker run -i --rm aec-model-bridge).
Sie nutzen VS Code? Der Quellcode der Erweiterung und die lokalen Installationsschritte registrieren den MCP-Server und zeigen den Verbindungsstatus zu Revit an. Sie ist nicht im Marketplace veröffentlicht.
Werkzeuge im Überblick
| Bereich | Werkzeuge | Was sie tun |
|---|---|---|
| Revit | 103 | Modell lesen, Elemente, Parameter, Ansichten, Pläne und Bauteillisten erstellen und bearbeiten, Exporte, Worksharing |
| Freigabe | 6 | Modelländerungen planen, prüfen, freigeben, ausführen und zurücksetzen |
| Module | 34 | Snapshot-Prüfung, Parametertabellen, QA/QC-Prüfungen, Rezepte, Berichte, Auswahlen |
| Rhino und Grasshopper | 19 | Geometrie, Layer, Materialien, boolesche Operationen |
| Speckle | 17 | Projekte, Modelle, Versionen, Senden und Empfangen |
| Navisworks | 15 | Modellbaum, Ansichtspunkte, Kollisionsprüfungen (in Arbeit) |
| IFC | 7 | IFC-Dateien ohne Revit lesen: Struktur, Eigenschaften, Validierung |
| Graph, Snapshots, Exporte, Jobs | 18 | Audits des semantischen Graphen, Snapshot-Vergleiche, SQLite-Export, Hintergrundjobs |
In der Standardkonfiguration werden 219 Werkzeuge aufgelistet (gezählt am aktuellen Server im Mock-Modus). Die Autodesk-Data-Werkzeuge erscheinen, wenn APS-Zugangsdaten konfiguriert sind. Die Werkzeugreferenz listet jedes Werkzeug auf. Jedes Werkzeug trägt MCP-Annotationen (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), sodass Clients Lese- von Schreibzugriffen unterscheiden können.
Erweiterte Revit-Automatisierung
Neben Modellabfragen und Parameteraktualisierungen erstellen die Revit-Werkzeuge Bauteile, Ansichten, Pläne, Bauteillisten, Beschriftungen und Bemaßungen und exportieren IFC-, DWG-, Bild- und Navisworks-Dateien. Unterstützte Operationen und Eingaben finden Sie in der Werkzeugreferenz.
Für alles, was der Werkzeugkatalog nicht abdeckt, arbeiten revit_invoke_method, revit_reflect_get und revit_reflect_set mit öffentlichen Mitgliedern der Revit-API, und revit_execute_python führt IronPython in Revit aus. Diese erweiterten Werkzeuge haben dieselben Berechtigungen wie der Revit-Prozess. Verwenden Sie sie nur mit MCP-Clients und Prompts, denen Sie vertrauen.
So funktioniert es
Der MCP-Client spricht mit einem Python-Hub. Der Hub leitet jeden Aufruf an den Provider weiter, dem das Werkzeug gehört. Provider für Desktop-Anwendungen sprechen über localhost mit einem kleinen Add-in in dieser Anwendung.
Diagrammquelle: architecture.mmd. Die Bilder erzeugen Sie mit python scripts/render_diagrams.py neu.
Türkise Kästen funktionieren bereits. Die gelb gestrichelten Kästen sind in Arbeit. Indigofarbene Formen stehen für Daten und externe Dienste.
So funktioniert die Freigabe
Der Hub stoppt jeden Werkzeugaufruf, der das Modell ändert, sofern er keinen freigegebenen Plan mitbringt. Der Standardmodus ist required. Die KI schlägt einen Plan vor, Sie prüfen ihn im Revit-Seitenpanel, und das Add-in führt ihn im Hauptthread von Revit aus, Parameter- und Modellbearbeitungsaktionen jeweils in ihrer eigenen benannten Transaktion; Speichern, Synchronisieren und Skripte nicht, daher deckt Strg+Z sie nicht ab.
Diagrammquelle: approval-flow.mmd. Die Bilder erzeugen Sie mit python scripts/render_diagrams.py neu.
Erweist sich ein Plan als falsch, machen Sie ihn mit Strg+Z in Revit rückgängig. Jeder Parameterschreibvorgang ist eine eigene benannte Transaktion, daher kann ein Plan mehrere Tastendrücke brauchen. Ein Rückgängig in einem Schritt für einen ganzen Plan ist geplant, aber nicht gebaut. Ein zweiter Weg ist ein Revert-Plan: Der Assistent entwirft ihn mit plan_revert aus dem Nachweis eines ausgeführten Plans, und Sie geben ihn wie jeden anderen Plan frei. rollback_plan ist nur für Menschen gedacht und weder eine Schaltfläche noch ein Befehl; verlassen Sie sich daher nicht darauf. Keiner dieser Wege ist bisher in einer echten Revit-Sitzung geprüft (UNVERIFIED). Nicht umkehrbare Vorgänge, etwa das Schreiben von Dateien, werden von keinem davon rückgängig gemacht und verlangen noch keine zweite Bestätigung (geplant). Die Plans-Liste des Panels zeigt nur ausstehende Pläne; aec-model-bridge-approve show <plan_id> funktioniert für einen Plan in jedem Zustand, während proofs/-Bündel nur für Pläne existieren, die ausgeführt (oder versucht) wurden. Der Ablauf ist in ADR 0008 beschrieben.
Für unbeaufsichtigte Pipelines können Sie MCP_REVIT_APPROVAL_MODE=auto setzen. Das schaltet die Prüfung durch den Menschen ab; verwenden Sie es daher nur in einer kontrollierten Umgebung.
Unterstützte Revit-Versionen
| Revit-Version | Add-in-Ziel | Build-Werkzeuge |
|---|---|---|
| 2024 | .NET Framework 4.8 | .NET 8 SDK und .NET Framework 4.8 Developer Pack |
| 2025 | .NET 8 for Windows | .NET 8 SDK |
| 2026 | .NET 8 for Windows | .NET 8 SDK |
| 2027 | .NET 10 for Windows | .NET 10 SDK |
Außerdem benötigen Sie Windows 10 oder 11, Python 3.11 oder neuer und eine lizenzierte Revit-Installation der verwendeten Version. Der Mock-Modus führt den Server ohne Revit aus, was für Entwicklung und Tests nützlich ist.
Weitere Integrationen
| Integration | Status |
|---|---|
| Revit | Verfügbar. Natives C#-Add-in. |
| IFC (IfcOpenShell) | Verfügbar. Liest IFC-Dateien, ohne dass Revit läuft. |
| Rhino und Grasshopper | Verfügbar. Verbindet sich mit dem Rhino-Add-in auf localhost:3004. |
| Speckle | Verfügbar. Benötigt eine Speckle-Client-ID in Ihrer Umgebung. |
| Navisworks Manage | In Arbeit. Der Provider und seine Werkzeuge sind registriert. Das Navisworks-Add-in ist nicht fertig. |
| Power BI | In Arbeit. Provider und Werkzeug existieren, sind aber nicht im Hub registriert. |
| Excel, Parquet und DuckDB | Geplant. |
Produktnamen und Logos gehören ihren jeweiligen Inhabern. Das Banner verwendet sie nur, um zu zeigen, womit dieses Projekt zusammenarbeitet.
Revit-Add-in installieren
Am einfachsten (Windows): Laden Sie AECModelBridge-Setup-<version>.exe vom neuesten Release herunter, starten Sie es per Doppelklick, wählen Sie Ihre Revit-Versionen und starten Sie Revit neu. Es installiert das Add-in, den mitgelieferten Python-Server und, wenn Sie das Kontrollkästchen aktivieren, die Einstellungen für Claude Desktop und VS Code, mit einer Sicherung Ihrer aktuellen Einstellungen. Deinstalliert wird über die Windows-Einstellungen. Die folgenden Schritte sind für den Build aus dem Quellcode.
Sie installieren zwei Teile: den Python-MCP-Server und das Revit-Add-in. Die Live-Automatisierung von Revit braucht beide.
1. MCP-Server installieren
git clone https://github.com/Sam-AEC/aec-model-bridge.git
cd aec-model-bridge
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e packages/mcp-server-revit
2. Revit-Add-in installieren
Stellen Sie die Version passend zu Ihrer Revit-Installation ein. Wenn Windows die heruntergeladenen Skripte blockiert, klicken Sie jede .ps1-Datei mit der rechten Maustaste an, öffnen Sie die Eigenschaften und wählen Sie vor dem Ausführen „Zulassen“.
$RevitVersion = Read-Host "Revit year (2024, 2025, 2026, or 2027)"
.\scripts\package.ps1 -RevitVersion $RevitVersion
.\scripts\install.ps1 -RevitVersion $RevitVersion
Das Installationsprogramm legt die versionsspezifischen Binärdateien ab in:
C:\ProgramData\AECModelBridge\bin\<year>
Das Add-in-Manifest wird pro Benutzer installiert in:
%APPDATA%\Autodesk\Revit\Addins\<year>
Mit -AllUsers bei install.ps1 wird das Manifest stattdessen unter C:\ProgramData\Autodesk\Revit\Addins\<year> installiert.
So bereiten Sie die Binärdateien für alle unterstützten Versionen in einem Durchgang vor:
.\scripts\package.ps1 -RevitVersion All
Jedes GitHub-Release enthält ein fertiges Paket pro Revit-Jahr, zum Beispiel aec-model-bridge-revit-2026-<version>.zip. Entpacken Sie es und führen Sie .\install.ps1 -RevitVersion 2026 aus, statt aus dem Quellcode zu bauen. Ein Windows-Installer zum Doppelklicken wird mit scripts/build-installer.ps1 und Inno Setup erzeugt. Die vollständige Anleitung mit Fehlerbehebung steht in docs/install.md.
Claude Desktop mit Revit verbinden
Tragen Sie den Server in die Konfiguration Ihres MCP-Clients ein. Bei Claude Desktop ist das der Abschnitt mcpServers in claude_desktop_config.json. Codex, Cursor, VS Code und andere MCP-Clients verwenden dieselben Werte für command, args und env in ihrem eigenen Konfigurationsformat.
Verwenden Sie die Python-Programmdatei Ihrer virtuellen Umgebung und wählen Sie einen Arbeitsordner, auf den der Server zugreifen darf:
{
"mcpServers": {
"aec-model-bridge": {
"command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
"args": ["-m", "revit_mcp_server.mcp_server"],
"env": {
"MCP_REVIT_MODE": "bridge",
"MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
"MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
}
},
"aec-model-bridge-revit-2026": {
"command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
"args": ["-m", "revit_mcp_server.mcp_server"],
"env": {
"MCP_REVIT_MODE": "bridge",
"MCP_REVIT_HOST_VERSION": "2026",
"MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
"MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
}
}
}
}
Lassen Sie MCP_REVIT_HOST_VERSION weg, um die neueste geöffnete Revit-Instanz anzusprechen. Setzen Sie es auf ein Jahr wie 2024 oder 2026, um einen Client-Eintrag auf diese Revit-Version festzulegen. MCP_REVIT_BRIDGE_URL überschreibt den Endpunkt für fortgeschrittene Setups.
VS-Code-Nutzer können mit .vscode/mcp.json beginnen. Hermes-Desktop-Nutzer können nach dem Ersetzen des Platzhalter-Python-Pfads mit docs/examples/hermes-desktop.json beginnen. Clients mit Unterstützung für MCP Bundles können die .mcpb-Datei aus dem neuesten Release installieren. Das Revit-Add-in ist weiterhin erforderlich, weil der Server mit der laufenden Desktop-Anwendung spricht.
Verbindung prüfen
Starten Sie Revit nach der Installation des Add-ins neu, öffnen Sie ein Modell und führen Sie aus:
$registry = Get-ChildItem "$env:LOCALAPPDATA\AECModelBridge\registry\revit-*.json" | Select-Object -First 1
$switch = Get-Content $registry.FullName -Raw | ConvertFrom-Json
Invoke-RestMethod "$($switch.endpoint)/health"
Die Antwort sollte healthy und die laufende Revit-Version melden. Suchen Sie in Revit den Ribbon-Reiter AEC Bridge. Das Panel Workflows enthält Open Panel, Health Check, Pending Actions und Reports. Das Panel Tools enthält Config, Help und About.
Sicherheit
- Die Revit-Bridge ist nur über localhost erreichbar.
- Der Server liest und schreibt nur in den Ordnern aus
MCP_REVIT_ALLOWED_DIRECTORIES. - Werkzeuge, die das Modell ändern, benötigen einen freigegebenen Plan, sofern Sie die Freigabe nicht abschalten.
- Werkzeugaufrufe werden in ein Audit-Protokoll geschrieben, Secrets (Zugangsdaten) werden maskiert.
Details stehen in docs/security.md. Um eine Sicherheitslücke zu melden, folgen Sie SECURITY.md.
FAQ
Was ist ein MCP-Server für Revit?
Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Assistenten Werkzeuge in anderer Software aufrufen können. Ein MCP-Server für Revit stellt Revit-Operationen als Werkzeuge bereit. Der Assistent wählt die Werkzeuge aus, und das Add-in führt sie in Revit aus.
Mit welchen KI-Assistenten funktioniert es?
Mit jedem MCP-Client, der einen lokalen stdio-Server starten kann. Dokumentiert sind Claude Desktop, VS Code mit GitHub Copilot, Cursor und Codex sowie Clients, die eine Standard-mcpServers-Konfiguration lesen. Windsurf, Cline, Roo Code, Continue, Zed, Claude Code und Gemini CLI sollten auf dieselbe Weise funktionieren, wurden aber nicht getestet. Siehe Kompatibilität. Der Panel-Chat kann auch einen Anthropic-API-Schlüssel oder die Kommandozeilenwerkzeuge claude oder codex nutzen, sofern sie installiert sind. Siehe ADR 0012.
Kann die KI mein Modell ohne Rückfrage ändern?
Im Standardmodus nicht. Werkzeuge, die das Modell ändern, sind gesperrt, bis ein Plan im Revit-Panel freigegeben wurde. Schreibgeschützte Werkzeuge laufen ohne Freigabe. Wenn Sie MCP_REVIT_APPROVAL_MODE=auto setzen, entfällt die Freigabe.
Wird mein Modell in die Cloud gesendet?
Server und Add-in laufen auf Ihrem Rechner, und die Bridge ist nur über localhost erreichbar. Was der KI-Assistent sieht, hängt vom verwendeten Client ab: Die Werkzeugergebnisse gehen an den Modellanbieter dieses Clients. Cloud-Provider wie Speckle laufen nur, wenn Sie sie konfigurieren und ihre Werkzeuge aufrufen.
Funktioniert es mit IFC-Dateien ohne Revit?
Ja. Der IFC-Provider liest Dateien mit IfcOpenShell. Er liefert Dateimetadaten, die räumliche Struktur, Elementeigenschaften und Bounding Boxes, führt Abfragen nach Klasse, GUID, Name oder Eigenschaft aus und validiert das Schema. IFC-Dateien bearbeitet er nicht.
Kann ich es ohne installiertes Revit nutzen?
Sie können den Server für Entwicklung und Tests im Mock-Modus ausführen. Für die Arbeit am Live-Modell benötigen Sie Revit 2024 bis 2027 und das Add-in.
Releases und Versionen
AEC Model Bridge folgt der semantischen Versionierung. Releases werden auf GitHub mit vX.Y.Z getaggt, und eine VERSION-Datei im Stammverzeichnis enthält die Versionsnummer. Den Release-Prozess beschreibt docs/versioning.md, die Änderungen jeder Version stehen in CHANGELOG.md.
Entwicklung
# Python tests
python -m pytest packages/mcp-server-revit/tests
# Build one Revit version, for example 2026
.\scripts\build-addin.ps1 -RevitVersion 2026 -Configuration Release
# Build all supported versions
.\scripts\package.ps1 -RevitVersion All
Die CI baut den Python-Server und die Add-in-Ziele für Revit 2024 bis 2027. Lesen Sie CONTRIBUTING.md, bevor Sie einen Pull Request öffnen.
Dokumentation
- Installationsanleitung
- Werkzeugreferenz
- Architektur
- Konfigurationsreferenz
- Sicherheit
- MCP-Clients und Registry
- Versionierung und Releases
- Gesamte Dokumentation
- Mitwirken und Verhaltenskodex
- Mitwirkende
Built with
AEC Model Bridge stands on open-source work. It is independent and is not affiliated with or endorsed by any project named here.
- Model Context Protocol Python SDK (MIT) for the MCP server
- IfcOpenShell (LGPL-3.0-or-later) for IFC files
- specklepy (Apache-2.0) for Speckle
- pydantic, httpx, NetworkX, openpyxl and PyYAML (MIT or BSD)
- Anthropic Python SDK (MIT) for the built-in agent chat
- Serilog, IronPython and Microsoft WebView2 in the Revit add-in
- Autodesk Revit and Navisworks and McNeel Rhino are separate products that you license yourself. This project does not include their code.
Licence texts and the full list of packages are in THIRD_PARTY_NOTICES.md. Licences were read from package metadata; rows that could not be verified are marked as such.
Projekt und Lizenz
Gepflegt von A. Sam Mohammad. LinkedIn | Issues
GPL-3.0-or-later mit der Revit Linking Exception oder eine kommerzielle Lizenz.