flachdach-archicad
DIN-18531-konformer Flachdach-Konstruktionsexperte für ArchiCAD. Das Plugin steuert ArchiCAD über einen MCP-Server (archicad-tapir via uvx) und unterstützt die vollständige Planung von Flachdächern: Schichtaufbau, Gefälleplanung, Entwässerung, Attika-Konstruktion, Anschlussdetails und Composites.
Was das Plugin liefert
| Komponente | Typ | Beschreibung |
|---|
flachdach-archicad | Skill | Automatisches Kontextwissen zu DIN 18531, Schichtaufbau, Entwässerungsplanung, Anschlussdetails; wird bei Flachdach-Aufgaben selbstständig aktiviert |
flachdach-archicad-experte | Agent | Spezialisierter Planungsagent; orchestriert ArchiCAD-MCP-Calls, prüft DIN-Konformität und führt mehrstufige Konstruktionsabläufe durch |
/flachdach-neu | Command | Legt ein neues Flachdach-Projekt an (Grundriss, Schichtaufbau, Entwässerungskonzept) |
/flachdach-check | Command | Prüft den aktuellen Dachaufbau auf DIN-18531-Konformität und gibt strukturiertes Feedback |
/flachdach-schnitt | Command | Erzeugt einen Regelschnitt durch Dachaufbau, Attika oder Anschluss |
scripts/setup.ps1 / scripts/setup.sh | Skript | Verifiziert die uvx-Installation und die MCP-Server-Verbindung (PowerShell 7 für Windows, bash für macOS/Linux) |
Voraussetzungen
- Betriebssystem: Windows 10/11 oder macOS/Linux
- ArchiCAD 29 mit installiertem Tapir Additional JSON Commands Add-On v1.4.0 (Add-On muss in ArchiCAD aktiv sein und auf Port 19723 lauschen)
- uv / uvx: installiert und im PATH verfügbar —
uvx startet den MCP-Server automatisch beim Aktivieren des Plugins. Installationsanleitung: docs.astral.sh/uv
Installation
-
Repository klonen oder Symlink setzen:
Windows (PowerShell 7):
# Variante A — direkt im Plugin-Verzeichnis arbeiten
cd <Pfad-zum-Repo>
# Variante B — als Claude-Plugin verlinken
New-Item -ItemType Junction -Path "$env:USERPROFILE\.claude\plugins\flachdach-archicad" -Target "<Pfad-zum-Repo>"
macOS/Linux (bash):
# Variante B — als Claude-Plugin verlinken
ln -s <Pfad-zum-Repo> ~/.claude/plugins/flachdach-archicad
-
Setup-Skript ausführen (prüft uvx-Installation und testet MCP-Serververbindung):
Windows:
.\scripts\setup.ps1
macOS/Linux:
bash scripts/setup.sh
-
Ausführlichere Schritte (manuelle Installation, Troubleshooting) siehe docs/admin-handbuch.md.
MCP-Server-Überblick
Das Plugin nutzt einen MCP-Server, der beim Aktivieren des Plugins über .mcp.json automatisch von Claude Code gestartet wird. Beim ersten Start lädt uvx das Paket tapir-archicad-mcp aus PyPI (~150 MB); danach steht ein lokaler Cache bereit.
| Server | Tools | Stärken |
|---|
| archicad-tapir | 3 Meta-Tools | Semantische Discovery über alle Tapir-Commands; kann echte Wände, Slabs, Composites und komplexe Dachaufbauten als ArchiCAD-Elemente anlegen |
Die drei Meta-Tools sind discovery_list_active_archicads, archicad_discover_tools(query) und archicad_call_tool(name, arguments).
