Rhino MCP

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

Die Windows-Erfahrung ist bewusst kurz:

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 dem Prompten.

Kein Rhino Package Manager, kein Repository-Klon, keine Python-Installation, keine uv-Umgebung, 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.

Install

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 vom neuesten Release herunter und doppelklicken Sie darauf. Der Installer fragt nach dem AI-Client und dann automatisch:

• 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-Prüfungen durch; und

• fügt einen normalen Eintrag zu den Windows-Installierten Apps hinzu, für eine saubere Entfernung.

Der Installer benötigt kein Online-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.

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

.\RhinoMCP-Windows-Setup-0.3.3.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.

Related MCP server: Grasshopper MCP

Was in Rhino erscheint

Das andockbare Rhino MCP-Panel öffnet sich automatisch bei jedem Start von Rhino. Es bleibt sichtbar, bis der Benutzer es ausblendet, bleibt für den Rest dieser Sitzung ausgeblendet und erscheint beim nächsten Rhino-Start erneut. Führen Sie den Befehl RhinoMCP jederzeit aus, um es manuell anzuzeigen oder auszublenden.

Das Panel passt in die normale Panel-/Kopfzeilenleiste von Rhino. Seine Überschrift zeigt Verbunden – bereit, Rhino zu steuern, Rhino MCP läuft – warte auf den AI-Client oder eine umsetzbare Stopp-/Nicht-konfiguriert-Nachricht. Es zeigt außerdem:

• MCP-Server verbunden oder wartend

• Rhino-Brücke verbunden oder gestoppt

• Grasshopper verfügbar oder nicht ausgeführt

• ausgewählter AI-Client und Toolprofil

• Rhino- und Grasshopper-Ports

• letzte Protokolle

• Neustart, Testwürfel erstellen und Doctor-Befehl kopieren-Schaltflächen

Der Installer enthält beide Rhino-8-Laufzeitversionen. 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 auswählen oder konfigurieren.

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

Erweiterte Befehle

Die Schaltfläche Doctor-Befehl kopieren im Rhino-Panel kopiert den korrekten vollständigen Pfad für Installer-Benutzer. 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, anstatt als Socket-Spuren.

Toolprofile

Basic (default)

Das sichere Alltagsset:

• 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, Inspektion ausgewählter/Objekte und Neuberechnungswerkzeuge hinzu. Die gebündelte .gha startet ihre Brücke automatisch, wenn Grasshopper geöffnet wird; es gibt keine .gh-Definition oder Python-Komponente zu laden.

Developer

Fügt explizit beliebige Rhino- und Grasshopper-Python-Werkzeuge hinzu. Sie fehlen in den Basic- und Grasshopper-Toolschemas, 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.

• Ein Batch 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, nicht in Zeichenfolgen eingebettetes JSON.

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

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

Beispielaufforderung:

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, anstatt wiederholt vollständig zurückgegeben zu werden.

• 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 darauf gemarshallt.

• Werkzeugbeschreibungen und normale Antworten sind absichtlich kompakt, um die Modell-Token-Nutzung zu reduzieren.

Ändern Sie die Bildstandardeinstellungen 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 Releases 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
        │ framed, persistent localhost TCP
        ▼
RhinoMCP.rhp ── Rhino document + dockable panel
        │
        └── RhinoMCP.Grasshopper.gha (persistent localhost HTTP)

Beide Brücken binden nur an 127.0.0.1; sie sind nicht für das Netzwerk freigegeben.

Lizenz

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