Rhino MCP

Codex、Claude、Cursor 向けの、手間のかからない Rhino と Grasshopper のブリッジ。

Windows での操作は意図的に短く設計されています：

1. RhinoMCP-Windows-Setup をダウンロードして実行します。

2. Codex、Claude、Cursor のいずれかを選択します。

3. Rhino を開き、Grasshopper を開いて、プロンプトを開始します。

通常のセットアップには、Rhino Package Manager、リポジトリのクローン、Python のインストール、uv、Conda 環境、Rhino Python スクリプト、Grasshopper ファイル、Python パスの変更、ターミナルコマンド、手動編集による MCP 設定は一切含まれません。

インストール

Rhino 8.0 以降と、使用する AI クライアントが必要です。Rhino 8.1 は Rhino を更新せずにサポートされています。Rhino を閉じ、最新リリース から単一の RhinoMCP-Windows-Setup-*.exe ファイルをダウンロードして、ダブルクリックします。インストーラーは AI クライアントを尋ね、その後自動的に次の操作を実行します：

• Rhino に同梱のインストーラーを使用して Rhino と Grasshopper のブリッジをインストールします。

• 完全なランタイムを備えた自己完結型の MCP サーバーをインストールします。

• Codex、Claude、Cursor の MCP エントリを安全に書き込みます。

• 安全な Grasshopper ツールプロファイルを選択します。

• ドクターチェックを実行します。

• クリーンな削除のために、Windows の インストール済みアプリ に通常のエントリを追加します。

インストーラーは Rhino がオンラインである必要はなく、依存関係をダウンロードせず、Rhino MCP が自動更新されることもありません。別のバージョンをインストールするには、常に別のインストーラーを明示的に実行する必要があります。

管理された展開やサイレント展開の場合、同じダウンロードで次の操作がサポートされます：

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

有効なクライアント値は codex、claude、cursor です。セットアップ後、選択した AI クライアントを再起動してください。Codex ユーザーは /mcp を実行して rhino-mcp が有効になっていることを確認できます。

Related MCP server: Grasshopper MCP

Rhino に表示されるもの

ドッキング可能な Rhino MCP パネルは、Rhino が起動するたびに自動的に開きます。ユーザーが非表示にするまで表示され続け、そのセッションの残りは非表示のままになり、次の Rhino 起動時に再び表示されます。RhinoMCP コマンドをいつでも実行して、手動で表示または非表示にできます。

パネルは Rhino の通常のパネル/ヘッダーストリップに収まります。見出しには、接続済み — Rhino にプロンプトを送信できます、Rhino MCP は実行中 — AI クライアントを待機中、または対処可能な停止/未設定メッセージが表示されます。また、次の項目も表示されます：

• MCP サーバーが接続済みまたは待機中

• Rhino ブリッジが接続済みまたは停止中

• Grasshopper が利用可能または未実行

• 選択した AI クライアントとツールプロファイル

• Rhino と Grasshopper のポート

• 最近のログ

• 再起動、テストキューブを作成、ドクターコマンドをコピー ボタン

インストーラーには Rhino 8 の両方のランタイムビルドが含まれています。Rhino は通常のランタイムでは net7.0 を、レガシー .NET Framework ランタイム用に構成されている場合は net48 を自動的に使用します。ユーザーがこれを選択または構成する必要はありません。

接続テストでは、1 ユニットのキューブを作成し、検証して、削除します。クリーンアップが無効になっている場合、テストキューブはドキュメントに残ります。

詳細コマンド

Rhino パネルの ドクターコマンドをコピー ボタンは、インストーラーユーザー向けの正しいフルパスをコピーします。ソースおよび Python パッケージのインストールでは、次のコマンドを使用できます：

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 は、パッケージ、設定、すべての AI クライアント、Rhino、Grasshopper、サーバーランチャーについて、合格/不合格/待機状態を報告します。Rhino と Grasshopper が閉じている場合は、ソケットトレースではなく、正確な次のアクションとともに WAIT として表示されます。

ツールプロファイル

基本（デフォルト）

安全な日常使用向けのセット：

• 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

ページ分割された定義コンテキスト、選択/オブジェクト検査、再計算ツールを追加します。同梱の .gha は Grasshopper が開くと自動的にブリッジを起動します。読み込む .gh 定義や Python コンポーネントはありません。

開発者

任意の Rhino および Grasshopper Python ツールを明示的に追加します。これらは基本および Grasshopper のツールスキーマには含まれていないため、AI クライアントが誤って発見したり呼び出したりすることはありません。安全な高レベル操作が依然として推奨されます。

安全な編集動作

• すべての変更リクエストには、名前付きの Rhino アンドゥレコードが作成されます。

• バッチはすべての操作を 1 つのトランザクションで実行し、再描画は 1 回だけ行います。

• ジオメトリおよびレイヤーツールは、検証とプレビューのために dry_run: true を受け入れます。

• 削除には明示的な Rhino オブジェクト ID が必要です。

• 読み取り結果は構造化オブジェクトであり、文字列内に JSON エンコードされたものではありません。

• オブジェクトおよび Grasshopper のリストはフィルタリングされ、ページ分割されます。

• get_scene_changes は、指定されたシーンバージョン以降の追加、編集、削除のみを送信します。

プロンプトの例：

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.

信頼性とパフォーマンス

• 4 バイトの長さプレフィックス付きメッセージが、従来の巨大な受信バッファを置き換えます。

• リクエストは、64 MiB のハードリミット付きで、境界のある 64 KiB チャンクで読み取られます。

• Rhino TCP および Grasshopper HTTP 接続は維持され、再利用されます。

• 失敗した安全な読み取りは、自動的に 1 回再接続されます。

• 変更操作は盲目的に再試行されることはなく、重複ジオメトリを防ぎます。

• 短命のシーンメタデータはキャッシュされ、編集後に無効化されます。

• シーンの変更と大きなドキュメントは、繰り返し全体を返すのではなく、ページ分割されます。

• Grasshopper コンテキストはデフォルトで簡略化されます。

• ビューキャプチャはデフォルトで圧縮 JPEG になり、サイズと品質を設定できます。

• ソケット処理と画像エンコードは Rhino の UI スレッドから離れて実行され、Rhino API 呼び出しのみがそのスレッドにマーシャリングされます。

• ツールの説明と通常の応答は、モデルのトークン使用量を減らすために意図的にコンパクトになっています。

画像のデフォルトを変更するには：

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

開発者ビルド

Python パッケージ：

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

Rhino 8 プラグインと Package Manager アーカイブ：

./scripts/build-yak.sh Release

スクリプトは dist/ の下に RhinoMCP.rhp、RhinoMCP.Grasshopper.gha、および .yak をビルドします。

完全な Windows インストーラー（Windows で PowerShell で実行）：

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

CI は、バンドルされた Windows 実行可能ファイルと単一ファイルのインストーラーをコンパイルし、スモークテストします。タグ付きリリースには、インストーラー、その SHA-256 チェックサム、および手動の開発者アーティファクトが添付されます。

アーキテクチャ

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)

両方のブリッジは 127.0.0.1 にのみバインドされ、ネットワークには公開されません。

ライセンス

MIT。このリポジトリはスタンドアロンであり、上流の Git リモートはありません。