Rhino MCP

Die reibungsarme Brücke zwischen Rhino und Grasshopper für Codex, Claude und Cursor.

Das Windows-Erlebnis ist bewusst kurz gehalten:

1. Laden Sie RhinoMCP-Windows-Setup herunter und führen Sie es aus.

2. Wählen Sie Codex, Claude oder Cursor.

3. Öffnen Sie Rhino, öffnen Sie Grasshopper und beginnen Sie mit Eingabeaufforderungen.

Kein Rhino Package Manager, kein Repository-Klon, keine Python-Installation, kein uv, keine Conda-Umgebung, kein Rhino-Python-Skript, keine Grasshopper-Datei, keine Änderung des Python-Pfads, kein Terminalbefehl und keine manuell bearbeitete MCP-Konfiguration gehören zum normalen Setup.

Installation

Erfordert Rhino 8.0 oder neuer und den AI-Client, den Sie verwenden möchten. Rhino 8.1 wird unterstützt, ohne Rhino zu aktualisieren. Schließen Sie Rhino, laden Sie die einzelne Datei RhinoMCP-Windows-Setup-*.exe aus der neuesten Version herunter und doppelklicken Sie darauf. Der Installer fragt nach dem AI-Client und führt dann automatisch Folgendes aus:

• installiert die Rhino- und Grasshopper-Brücken mit dem gebündelten Installer von Rhino;

• installiert einen eigenständigen MCP-Server mit seiner vollständigen Laufzeit;

• schreibt den Codex-, Claude- oder Cursor-MCP-Eintrag sicher;

• wählt das sichere Grasshopper-Toolprofil;

• führt die Doctor-Checks aus; und

• fügt einen normalen Eintrag zu Installierte Apps in Windows hinzu, für eine saubere Entfernung.

Der Installer benötigt keine Online-Verbindung für Rhino, lädt keine Abhängigkeiten herunter und Rhino MCP aktualisiert sich nie selbst. Die Installation einer anderen Version erfordert immer das bewusste Ausführen eines anderen Installers.

Beim Start von Rhino wird automatisch ein lokales Verbindungs-Dashboard im Standardbrowser von Windows geöffnet. Es funktioniert ohne Internetzugang und erfordert keine separate App, keinen Dienst und keine Browsererweiterung.

Related MCP server: Grasshopper MCP

Prüfungen der Architekturvorschriften

Rhino MCP enthält einen kompakten, offline durchsuchbaren Index, der aus der bereitgestellten Google-Drive-Regulierungsbibliothek erstellt wurde. Die Originaldateien werden außerhalb dieses öffentlichen Quellcode-Repositorys aufbewahrt; der gebündelte Index speichert durchsuchbaren Seitentext, Quellmetadaten und Links zurück zu den Originalen. Es handelt sich um einen festen Schnappschuss, der nie synchronisiert oder sich selbst aktualisiert. Der Schnappschuss enthält 289 Quelldateien, mit 272 durchsuchbaren Dokumenten und 7.896 indizierten Seiten. Aserbaidschanische, russische und englische OCR hat 553 gescannte PDF-Seiten und 66 Bild-/TIFF-Blätter ohne Extraktionsfehler wiederhergestellt.

Für Anfragen zu Architektur, Bauwesen, Barrierefreiheit, Brandschutz, Statik, Sanitär, Energie, Entwässerung, Unterkunft, Standortplanung oder verwandten Grasshopper-Themen erhält jeder MCP-Client eine immer aktive Workflow-Anweisung, um:

1. die Zuständigkeit, den Nutzungs-/Projekttyp, die Planungsphase und die Einschränkungen festzulegen;

2. die Regulierungsbibliothek zu durchsuchen, bevor regulierte Maße vorgeschlagen oder das Modell bearbeitet wird;

3. den genauen Dokumenttitel, die Drive-Quell-ID und die Seite für jede Anforderung zu zitieren;

4. verifizierte Quellenanforderungen von Empfehlungen und Schlussfolgerungen zu trennen; und

5. fehlende Nachweise, Konflikte, unsichere Anwendbarkeit und die Notwendigkeit einer lizenzierten lokalen Überprüfung zu kennzeichnen.

Dokumenttext wird als nicht vertrauenswürdige Referenzdaten behandelt, nicht als ausführbare Anweisungen. Die KI darf keine Code-Werte erfinden oder ihre Überprüfung als Genehmigung, Zulassung oder rechtliches Konformitätszertifikat beschreiben.

Die immer verfügbaren Regulierungswerkzeuge sind:

• regulation_library_status

• search_regulations

• get_regulation_page

• architecture_regulation_checklist

Die Suche erweitert gängige englische Architekturbegriffe ins Aserbaidschanische und Russische, damit das Modell das mehrsprachige Quellmaterial finden kann. Überprüfen Sie den installierten Schnappschuss oder versuchen Sie eine Suche mit:

rhino-mcp regulations status
rhino-mcp regulations search "fire evacuation stairs"

Die Quellensammlung und ihr geltender Rechtsstatus wurden nicht unabhängig zertifiziert. Ein verantwortlicher Architekt oder Ingenieur muss vor dem Bau die Zuständigkeit, Anwendbarkeit, Änderungen, Konflikte und aktuellen Anforderungen bestätigen.

Für verwaltete oder stille Bereitstellung unterstützt derselbe Download:

.\RhinoMCP-Windows-Setup-0.4.2.exe /CLIENT=codex /SILENT

Gültige Client-Werte sind codex, claude und cursor. Starten Sie den ausgewählten AI-Client nach dem Setup neu. Codex-Benutzer können /mcp ausführen, um zu bestätigen, dass rhino-mcp aktiviert ist.

Verbindungs-Dashboard

Bei jedem Start von Rhino öffnet Rhino MCP einen Dashboard-Tab im Standardbrowser von Windows. Es verwendet den Browser, den der Benutzer gewählt hat; Chrome ist nicht erforderlich. Die Seite zeigt den Live-Zustand von:

• Rhino Bridge — verbunden oder gestoppt

• Codex / Claude / Cursor — verbunden, wartend oder nicht konfiguriert

• Grasshopper — verbunden oder nicht geöffnet

• Regulierungen — geladen oder nicht installiert

Die Seite aktualisiert ihren Status einmal pro Sekunde. Wenn Rhino geschlossen wird, ändert sich der vorhandene Tab zu Rhino ist offline und versucht es weiter; wenn Rhino wieder geöffnet wird, verbindet es sich automatisch neu. Der Tab kann jederzeit geschlossen werden. Führen Sie RhinoMCPDashboard in Rhino aus, um ihn erneut zu öffnen.

Die Standardadresse ist http://127.0.0.1:9877/. Sie wird direkt vom Rhino-Plug-in bereitgestellt, bindet nur an diesen Computer, ist schreibgeschützt, lädt keine Web-Assets und sendet nichts ins Internet. Wenn dieser Port bereits belegt ist, wählt Rhino MCP automatisch einen privaten lokalen Fallback und öffnet die korrekte Adresse.

Was in Rhino erscheint

Der Rhino MCP-Verbindungsstreifen erscheint automatisch oben rechts im aktiven Modellierungs-Viewport bei jedem Start von Rhino. Er bleibt sichtbar, ohne Platz im Seitenpanel zu beanspruchen, folgt dem aktiven Viewport und erscheint beim nächsten Rhino-Start erneut, auch wenn er in der vorherigen Sitzung ausgeblendet wurde.

Die Überschrift lautet VERBUNDEN — BEREIT, WARTE AUF CODEX/CLAUDE/CURSOR, SETUP ERFORDERLICH oder BRÜCKE GESTOPPT. Vier Live-Punkte zeigen:

• Brücke — grün, wenn Rhino lauscht

• Codex / Claude / Cursor — grün, wenn der ausgewählte AI-Client verbunden ist

• Grasshopper — grün, wenn Grasshopper geöffnet und seine Brücke verfügbar ist

• Regeln — grün, wenn die Offline-Regulierungsbibliothek geladen ist

Der Streifen ist bewusst nicht in Viewport-Bildern enthalten, die an die KI zurückgegeben werden. Führen Sie RhinoMCP aus, um ihn auszublenden oder anzuzeigen. Zur Fehlerbehebung bietet Rhino außerdem:

• RhinoMCPDashboard — das Browser-Dashboard erneut öffnen

• RhinoMCPStatus — den Streifen anzeigen und den vollständigen Status, Ports und die Dashboard-URL ausgeben

• RhinoMCPRestart — die lokale Rhino-Brücke neu starten

• RhinoMCPTest — einen Testwürfel erstellen, verifizieren und automatisch entfernen

Der Installer enthält beide Rhino-8-Laufzeit-Builds. Rhino verwendet automatisch net7.0 in seiner normalen Laufzeit oder net48, wenn Rhino für die Legacy-.NET-Framework-Laufzeit konfiguriert ist; der Benutzer muss dies nicht wählen oder konfigurieren.

Der Verbindungstest erstellt einen Einheitswürfel, verifiziert ihn und entfernt ihn. Wenn die Bereinigung deaktiviert ist, bleibt der Testwürfel im Dokument.

Erweiterte Befehle

Quell- und Python-Paketinstallationen können verwenden:

rhino-mcp setup [codex|claude|cursor]
rhino-mcp doctor [--json]
rhino-mcp status [--json]
rhino-mcp update
rhino-mcp uninstall [--all]
rhino-mcp config [codex|claude|cursor]
rhino-mcp config --profile basic|grasshopper|developer

doctor meldet Bestanden/Fehlgeschlagen/Warten-Zustände für das Paket, die Einstellungen, jeden AI-Client, Rhino, Grasshopper und den Server-Launcher. Geschlossene Rhino- und Grasshopper-Instanzen werden als WAIT angezeigt, mit der genauen nächsten Aktion, statt als Socket-Spuren.

Tool-Profile

Basis (Standard)

Der sichere Alltagssatz:

• rhino_status

• get_scene_summary

• list_layers

• list_objects

• get_scene_changes

• create_geometry

• modify_objects

• delete_objects

• organize_layers

• batch_geometry

• test_connection

• capture_viewport

Grasshopper

Fügt paginierte Definitionskontexte, Auswahl-/Objektinspektion und Neuberechnungswerkzeuge hinzu. Das gebündelte .gha startet seine Brücke automatisch, wenn Grasshopper geöffnet wird; es gibt keine .gh-Definition oder Python-Komponente zum Laden.

Entwickler

Fügt explizit beliebige Rhino- und Grasshopper-Python-Werkzeuge hinzu. Sie fehlen in den Basis- und Grasshopper-Tool-Schemas, sodass ein AI-Client sie nicht versehentlich entdecken oder aufrufen kann. Sichere High-Level-Operationen werden weiterhin bevorzugt.

Sicheres Bearbeitungsverhalten

• Jede ändernde Anfrage erhält einen benannten Rhino-Undo-Datensatz.

• Eine Stapelverarbeitung führt alle Operationen in einer Transaktion aus und zeichnet einmal neu.

• Geometrie- und Ebenenwerkzeuge akzeptieren dry_run: true zur Validierung und Vorschau.

• Löschungen erfordern explizite Rhino-Objekt-IDs.

• Leseergebnisse sind strukturierte Objekte, kein JSON, das in Zeichenfolgen kodiert ist.

• Objekt- und Grasshopper-Listen werden gefiltert und paginiert.

• get_scene_changes sendet nur Hinzufügungen, Bearbeitungen und Löschungen seit einer angegebenen Szenenversion.

Beispiel-Eingabeaufforderung:

Create a 10 × 8 × 3 box on a layer named Massing. Dry-run it first, then create it
and show me a compressed viewport capture.

Zuverlässigkeit und Leistung

• 4-Byte-längenpräfixierte Nachrichten ersetzen den alten riesigen Empfangspuffer.

• Anfragen werden in begrenzten 64-KiB-Blöcken mit einem harten Limit von 64 MiB gelesen.

• Rhino-TCP- und Grasshopper-HTTP-Verbindungen werden am Leben gehalten und wiederverwendet.

• Ein fehlgeschlagener sicherer Lesevorgang verbindet sich automatisch einmal neu.

• Mutationen werden nie blind wiederholt, wodurch doppelte Geometrie verhindert wird.

• Kurzlebige Szenenmetadaten werden zwischengespeichert und nach Bearbeitungen ungültig gemacht.

• Szenenänderungen und große Dokumente werden paginiert, statt wiederholt vollständig zurückgegeben.

• Der Grasshopper-Kontext wird standardmäßig vereinfacht.

• Ansichtsaufnahmen verwenden standardmäßig komprimiertes JPEG mit konfigurierbarer Größe und Qualität.

• Socket-Arbeit und Bildkodierung laufen außerhalb des Rhino-UI-Threads; nur Rhino-API-Aufrufe werden auf ihn gemarshallt.

• Tool-Beschreibungen und normale Antworten sind bewusst kompakt, um den Token-Verbrauch des Modells zu reduzieren.

Ändern Sie die Bildstandards mit:

rhino-mcp config --image-size 1280 --image-quality 82

Entwickler-Build

Python-Paket:

python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q
python -m build

Rhino-8-Plug-in und Package-Manager-Archiv:

./scripts/build-yak.sh Release

Das Skript erstellt RhinoMCP.rhp, RhinoMCP.Grasshopper.gha und eine .yak unter dist/.

Vollständiger Windows-Installer (in PowerShell unter Windows ausführen):

python -m pip install -e ".[dev]" "pyinstaller==6.22.2"
choco install innosetup --yes
.\scripts\build-windows-installer.ps1

CI kompiliert und rauchtests die gebündelte Windows-Ausführungsdatei und den Einzeldatei-Installer. Getaggte Versionen fügen den Installer, seine SHA-256-Prüfsumme und die manuellen Entwickler-Artefakte hinzu.

Architektur

Codex / Claude / Cursor
        │ MCP stdio
        ▼
bundled rhino-mcp.exe
        ├── offline regulation search index
        │
        │ framed, persistent localhost TCP
        ▼
RhinoMCP.rhp ── Rhino document + visible viewport status strip
        ├── read-only browser dashboard at 127.0.0.1
        │
        └── RhinoMCP.Grasshopper.gha (persistent localhost HTTP)

Beide Brücken und das Dashboard binden nur an 127.0.0.1; sie sind nicht im Netzwerk exponiert.

Lizenz

MIT. Dieses Repository ist eigenständig und hat kein Upstream-Git-Remote.