revit-tunnel MCP（Einzelsegmente V2）

Dies ist ein dedizierter MCP, der unabhängig vom bestehenden allgemeinen Revit-MCP arbeitet. Über Node.js stdio MCP, die nur lokale pyRevit-Routes-Schnittstelle und die Revit-2025-API kann der Agent Schildtunnel in Vorschau anzeigen, erstellen und verifizieren. Die alte Version „ein Gesamtfamilientyp pro Ring" bleibt vollständig erhalten; V2 fügt „ein unabhängiger Familienbaustein pro Segment" hinzu.

Einzelsegment-Fähigkeiten

• Standardlayout 9A1K: 9 A-Segmente pro Ring (je 37,5°) und 1 K-Segment (22,5°).

• Standardmäßig erzeugen 10 Ringe 100 Generic Models-Familieninstanzen, die einzeln auswählbar, auswertbar, filterbar und in Listen darstellbar sind.

• Unterstützt 1–50 Ringe, aber jede Erstellung umfasst höchstens 500 Einzelsegmente.

• Unterstützt Außendurchmesser, Dicke, Ringbreite, 3D-Startpunkt, geradlinige Längsneigung sowie alternierende positive/negative Versatzfugen zwischen benachbarten Ringen.

• Pro Ring wird nur eine Arbeitsebene mit dem Namen RTM_SEG_HOST_* erstellt, die von allen Segmenten desselben Rings gemeinsam genutzt wird.

• Jedes Segment hat eine stabile Kennzeichnung, z. B. batch-R0001-A01, batch-R0001-K01.

• Die Batch-Erstellung ist in eine Revit-Transaktionsgruppe eingebettet; bei Fehlern in Familien oder Bauteilen werden Instanzen, Arbeitsebenen und die neu geladenen Familien gemeinsam zurückgerollt.

Related MCP server: RevitMCPBridge2026

Aktualisierbarer Familieninhalt

Der Familienname wird durch Bauteilrolle, Abmessungen, Winkel, Inhaltskonfiguration und Inhaltsversion bestimmt:

RTM_Segment_{role}_OD{outer}_T{thickness}_W{width}_S{spanMilliDeg}_{profile}_V{version}

Der aktuelle Inhaltsanbieter ist basic Version 1, der für jede Geometrie eine einfache ringförmige Sektorfamilie erzeugt. Der Type Comments des Familientyps speichert RTM_CONTENT:<hash>. Gleichnamige Familien werden nur dann wiederverwendet, wenn der Inhalts-Hash exakt übereinstimmt; fehlt der Hash oder weicht er ab, wird ein Konflikt gemeldet, ohne stillschweigend zu überschreiben.

Daher können künftig neue Inhaltsversionen veröffentlicht werden, wenn den Segmenten Verpressbohrungen, Schraubenlöcher, Handlöcher, Nuten oder Bewehrungsdarstellungen hinzugefügt werden. Alte Batches bleiben dauerhaft in ihrer ursprünglichen Familienversion eingefroren; Layout, Bauteilnummerierung und der Agent-Aufrufablauf müssen nicht umgeschrieben werden.

Bauteil-Identitätsparameter

Alle Einzelsegment-Familien verwenden 12 gemeinsame Instanzparameter mit festen GUIDs:

• RTM_BatchId, RTM_UniqueId

• RTM_RingIndex, RTM_SegmentIndex

• RTM_SegmentSlot, RTM_SegmentRole

• RTM_LayoutId

• RTM_ContentProfile, RTM_ContentVersion

• RTM_StartAngle, RTM_EndAngle, RTM_CenterAngle

Die festen GUIDs stellen sicher, dass künftige A-, B-, K-Familien sowie Versionen mit unterschiedlicher Genauigkeit weiterhin dieselben Listen, Filter und Beschriftungen verwenden können.

Acht MCP-Werkzeuge

Einzelsegmente V2:

• list_tunnel_segment_catalog: Listet Layouts und Inhaltsversionen auf.

• preview_tunnel_segments: Schreibgeschützte Validierung und Rückgabe des vollständigen segmentweisen Plans sowie eines Vorschau-Tokens.

• create_tunnel_segments: Erfordert dieselben Parameter, preview_token und confirm=true zur Erstellung.

• inspect_tunnel_segment_batch: Schreibgeschützte Rückabfrage von Identität, Familienversion, Position, Ausrichtung, Volumen und tragender Arbeitsebene jedes Bauteils.

Erhaltene Gesamtring-V1:

• preview_tunnel_rings

• create_tunnel_rings

• inspect_tunnel_batch

• get_tunnel_backend_status (gemeinsam von V1/V2 genutzt)

Die empfohlene Aufrufreihenfolge ist: Backend prüfen → Katalog auflisten → Vorschau → Benutzerbestätigung → Erstellen → Batch prüfen.

Späterer Wechsel auf 6A＋2B＋1K

Layout und Familieninhalt sind bereits geschichtet. Wenn künftig 6A2B1K hinzugefügt wird, müssen im versionierten Katalog nur 9 Slots sowie die Winkelregeln für A/B/K ergänzt werden; Platzierer, Identitätsparameter, MCP-Werkzeuge und Prüfschnittstellen bleiben unverändert. Falls sich B geometrisch von A unterscheidet, löst das System automatisch die neue Familienspezifikation anhand von Rolle und Winkel auf.

Sicherheitsgrenzen

• Routes lauscht nur auf 127.0.0.1:48884 und ist nicht im LAN erreichbar.

• Node-Vorschau und pyRevit-Backend validieren den vollständigen Plan jeweils unabhängig; V2 berechnet zusätzlich Layout-Zusammenfassung, ringweise Positionen, segmentweise Winkel, Kennzeichnungen, Familiennamen und Inhalts-Hashes neu.

• Gesamtringe und Einzelsegmente teilen sich den globalen batch_id-Namensraum; eine doppelte Erstellung wird abgelehnt, sobald eine der beiden Seiten bereits existiert.

• Derzeit gibt es keine Werkzeuge zum Löschen, Überschreiben oder Aktualisieren bestehender Batches.

• Das bestehende allgemeine Revit-MCP und die ShieldTunnel.extension wurden nicht verändert.

Installation

• Quellcode: Projektverzeichnis nach dem Klonen dieses Repositories

• pyRevit-Erweiterung: %USERPROFILE%\Documents\pyRevit Extensions\RevitTunnelMcp.extension

• Codex-Konfiguration: [mcp_servers.revit_tunnel] in %USERPROFILE%\.codex\config.toml

Zuerst Node.js 22 und die Projektabhängigkeiten installieren:

npm install

Erweiterung neu installieren:

& '.\scripts\install.ps1' -RoutesPort 48884

Nach Installation oder Änderung muss pyRevit neu geladen (oder Revit neu gestartet) werden.

Verifizierung und Smoke-Test

npm test
python -m pytest -q '.\pyrevit\tests'
node '.\scripts\smoke-test.mjs' --segments --inspect --batch-id=<批次>

Test-Batch mit zwei Ringen Einzelsegmenten erstellen:

node '.\scripts\smoke-test.mjs' --segments --create --ring-count=2 --batch-id=segment-e2e-01

Der alte Gesamtring-Aufruf verwendet kein --segments. --create verändert das aktuelle Revit-Projekt tatsächlich und sollte nur in Testkopien oder bestätigten Projekten verwendet werden.