jingcheng-chen/rhinomcp

RhinoMCP – AI駆動のRhino 3DおよびGrasshopper制御

何であるか – 大規模言語モデルエージェント（Claude、Cursor、Codexなど）がRhino 3Dおよびそのビジュアルプログラミング環境Grasshopperと通信できるようにする、小さなオープンソースブリッジです。Model Context Protocol（MCP）を実装しており、AIが自然言語で高レベルのコマンドを発行し、Rhinoビューポートからの視覚フィードバックを受け取ることができます。

主な機能

• ジオメトリの作成と編集 – ポイント、曲線、サーフェス、ソリッド、ブーリアン、ロフト、スイープなど、1つずつまたは一括で。
• シーンの検査 – オブジェクトリスト、属性、レイヤーを照会する、または現在のビューポートのスクリーンショットを取得してモデルが「見る」ようにする。
• Grasshopperスクリプティング – コンポーネントを検索し、キャンバスに追加し、パラメータを接続し、スライダー値を設定し、ソルバーを実行する、または1回の呼び出しで完全な定義を再構築する。
• 低レベルアクセス – 任意のネイティブRhinoコマンドを実行し、RhinoScript-Pythonを実行する、またはRhinoCommon C#コードを実行する（これらの強力なツールを無効にするオプション付き）。
• 双方向インタラクション – AIはジオメトリを生成し、モデルの状態を読み取ることができ、反復的なデザインループを可能にする。

動作方法

1. Python MCPサーバー（PyPIのrhinomcp）をローカルで実行し、標準のMCP stdioインターフェース経由でツールセットを公開する。
2. Rhinoプラグイン（Rhinoのパッケージマネージャー経由でインストール）がRhino内にTCPリスナーを起動する（デフォルト 127.0.0.1:1999）。
3. AIクライアントがサーバーをMCPエンドポイント（rhino）として登録し、JSONエンコードされたツール呼び出しを送信する；プラグインがメインRhinoスレッドでそれらを実行し、結果を返す。

導入方法

1. パッケージマネージャーからRhinoプラグインをインストール（rhinomcp）。
2. uvx rhinomcp@latest（または pip install rhinomcp）でPythonサーバーをインストールする。
3. サーバーをAIクライアントのMCP設定に追加する（例：codex mcp add rhino …）。
4. Rhinoでコマンド mcpstart を実行してTCPブリッジを開く。
5. アシスタントとチャットする：「青から赤へのグラデーションを持つ6×6×6のボックスグリッドを作成して」や「点からの距離に従って高さが変化する円筒を配置するGrasshopperグラフを作成して」と依頼する。

対象ユーザー – Rhino 8を既に使用しており、AI支援モデリングやGrasshopperワークフローの自動化を試したいデザイナー、建築家、エンジニア、開発者。自律的なデザインエージェントを開発する研究者にも有用です。

プロジェクト状態 – 活発にメンテナンス中（PyPIリリース、パッケージマネージャー経由でのRhinoプラグイン更新）。リポジトリにはPythonテストスイート、C#ビルドスクリプト、ツールセットの拡張用ドキュメントが含まれます。

ライセンス – MIT。