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が自己更新することはありません。別のバージョンをインストールするには、常に別のインストーラーを意図的に実行する必要があります。

Rhinoが起動すると、Windowsのデフォルトブラウザでローカル接続ダッシュボードが自動的に開きます。これはインターネット接続なしで動作し、別のアプリ、サービス、ブラウザ拡張機能は必要ありません。

Related MCP server: Grasshopper MCP

建築規制チェック

Rhino MCPには、提供されているGoogle Drive規制ライブラリから構築されたコンパクトなオフライン検索インデックスが含まれています。元のファイルはこの公開ソースリポジトリの外部に保存されています。同梱のインデックスには、検索可能なページテキスト、ソースメタデータ、および原本へのリンクが格納されています。これは固定スナップショットであり、同期や自己更新は一切行われません。スナップショットには289のソースファイルが含まれ、272の検索可能なドキュメントと7,896のインデックス化されたページがあります。アゼルバイジャン語、ロシア語、英語のOCRにより、553ページのスキャンされたPDFと66枚の画像/TIFFシートが抽出エラーなしで復元されました。

建築、建設、バリアフリー、防火、構造、衛生、エネルギー、排水、シェルター、敷地計画、または関連するGrasshopperリクエストについて、すべてのMCPクライアントは常時オンのワークフロー指示を受け取り、以下を実行します。

1. 管轄区域、用途/プロジェクトタイプ、設計段階、および制約条件を確立します。

2. 規制対象の寸法を提案したりモデルを編集したりする前に、規制ライブラリを検索します。

3. 各要件について、正確なドキュメントタイトル、DriveソースID、およびページを引用します。

4. 検証済みのソース要件と、推奨事項および推論を区別します。

5. 証拠の欠落、矛盾、適用可能性の不確実性、および資格のある現地レビューの必要性にフラグを立てます。

ドキュメントテキストは、実行可能な指示ではなく、信頼できない参照データとして扱われます。AIはコード値をでっち上げたり、自身のレビューを許可、承認、または法的適合証明書として説明したりしてはなりません。

常に利用可能な規制ツールは次のとおりです。

• regulation_library_status

• search_regulations

• get_regulation_page

• architecture_regulation_checklist

検索は一般的な英語の建築用語をアゼルバイジャン語とロシア語に展開し、モデルが多言語のソース資料を見つけられるようにします。インストール済みのスナップショットを確認するか、次のコマンドで検索を試してください。

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

ソースコレクションとその有効な法的地位は独立して認定されていません。責任ある建築家またはエンジニアは、建設前に管轄区域、適用可能性、修正、矛盾、および現在の要件を確認する必要があります。

管理されたサイレント展開の場合、同じダウンロードで以下がサポートされます。

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

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

接続ダッシュボード

Rhinoが起動するたびに、Rhino MCPはWindowsのデフォルトブラウザで1つのダッシュボードタブを開きます。ユーザーが選択したブラウザを使用します。Chromeは必要ありません。ページには次のライブ状態が表示されます。

• Rhino Bridge — 接続済みまたは停止中

• Codex / Claude / Cursor — 接続済み、待機中、または未設定

• Grasshopper — 接続済みまたは未起動

• Regulations — 読み込み済みまたは未インストール

ページはステータスを毎秒1回更新します。Rhinoが閉じると、既存のタブはRhino is offlineに変わり、再接続を試み続けます。Rhinoが再度開くと、自動的に再接続されます。タブはいつでも閉じることができます。RhinoでRhinoMCPDashboardを実行すると、再度開くことができます。

デフォルトのアドレスはhttp://127.0.0.1:9877/です。これはRhinoプラグインによって直接提供され、このコンピューターにのみバインドされ、読み取り専用で、Webアセットを読み込まず、インターネットに何も送信しません。そのポートがすでに使用されている場合、Rhino MCPはプライベートなローカルフォールバックを自動的に選択し、正しいアドレスを開きます。

Rhinoに表示されるもの

Rhino MCP接続ストリップは、Rhinoが起動するたびにアクティブなモデリングビューポートの右上に自動的に表示されます。サイドパネルのスペースを取らずに表示され続け、アクティブなビューポートに追従し、前回のセッションで非表示にされていた場合でも、次のRhino起動時に再度表示されます。

見出しにはCONNECTED — READY、WAITING FOR CODEX/CLAUDE/CURSOR、SETUP NEEDED、またはBRIDGE STOPPEDと表示されます。4つのライブドットが表示されます。

• Bridge — Rhinoが待機中の場合は緑

• Codex / Claude / Cursor — 選択したAIクライアントが接続されている場合は緑

• Grasshopper — Grasshopperが開いており、そのブリッジが利用可能な場合は緑

• Rules — オフライン規制ライブラリが読み込まれている場合は緑

このストリップは、AIに返されるビューポート画像には意図的に含まれません。RhinoMCPを実行して非表示または表示を切り替えます。トラブルシューティングのために、Rhinoは以下も提供します。

• RhinoMCPDashboard — ブラウザダッシュボードを再度開く

• RhinoMCPStatus — ストリップを表示し、完全なステータス、ポート、ダッシュボードURLを出力する

• RhinoMCPRestart — ローカルのRhinoブリッジを再起動する

• RhinoMCPTest — テストキューブを作成、検証、自動削除する

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

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

詳細コマンド

ソースおよび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 KiBの境界チャンクで読み取られ、64 MiBのハードリミットがあります。

• 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
        ├── 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)

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

ライセンス

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