Rhino

RhinoMCP

自然な言葉で、AI を使って Rhino 3D と Grasshopper を操作できます。

RhinoMCP は、Model Context Protocol を介して Rhino と AI エージェントを接続します。 これにより、Claude や Cursor などのアシスタントは、会話するだけでジオメトリをモデリングしたり、ドキュメントを読み取ったり、 Grasshopper の定義を作成したりできます。

クイックスタート · できること · 使い方 · 例 · ツールリファレンス

English · 简体中文

特長

自律的な改善実験を開発する場合は、まず 継続ガイドをご覧ください。

• 作りたいものを説明すると、アシスタントが Rhino で作成します。
• ドキュメントを読み取り、ビューポートをキャプチャできるため、実際に画面に表示されている内容をもとに作業します。
• Grasshopper のスクリプトを作成します。コンポーネントの検索、接続、スライダーの設定、ソルブまで行います。
• 1 つのプラグインと 1 つの設定項目で、Rhino と Grasshopper の両方に対応します。
• さらに細かく制御したい場合は、ネイティブの Rhino コマンド、RhinoScript-Python、または RhinoCommon C# を実行できます。

メモ

RhinoMCP は、Windows および macOS 上の Rhino 8 を対象としています。

デモ

手順を追った説明をご希望ですか？Nate が、紹介動画とインストール方法を解説するYouTube のチュートリアルを公開しています。

できること

Rhino

Grasshopper

クイックスタート

3 つの手順で完了します。Rhino プラグインをインストールし、AI クライアントを接続してから、Rhino でブリッジを起動します。

1. Rhino プラグインをインストールする

Rhino で Tools → Package Manager を開き、rhinomcp を検索して Install をクリックします。Rhino を再起動します。

2. AI クライアントを接続する

オプション A：AI アシスタントにインストールを依頼する（推奨）

エージェント型アシスタント（Codex、Claude Code、Cursor、Cline など）を使用している場合は、このプロンプトを貼り付けます。

Please install https://github.com/jingcheng-chen/rhinomcp as a local MCP server named `rhino`.

オプション B：MCP サーバーをインストールするか、設定を手動で編集する

Codex：次の 1 つのコマンドで設定します。

codex mcp add rhino --env RHINO_MCP_HOST=127.0.0.1 -- uvx rhinomcp@latest

Claude Code：次の 1 つのコマンドで設定します。

claude mcp add rhino -- uvx rhinomcp@latest

ChatGPT： 上記のローカルセットアップには Codex を使用してください。ChatGPT アプリ／MCP コネクターは現在、リモート MCP サーバーに接続します。uvx rhinomcp のようなローカルの stdio コマンドには接続しません。RhinoMCP を使った ChatGPT アプリを構築する場合は、リモートまたはトンネル経由の MCP エンドポイントを使用して、ChatGPT の開発者モードを利用してください。

設定を手動で編集することもできます。

{
  "mcpServers": {
    "rhino": {
      "command": "uvx",
      "args": ["rhinomcp@latest"],
      "env": {
        "RHINO_MCP_HOST": "127.0.0.1"
      }
    }
  }
}

重要

起動ツールの uvx は uv に含まれています。まだインストールしていない場合： macOS brew install uv · Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

一度に起動する RhinoMCP サーバーは 1 つだけにしてください（Codex、Claude、Cursor など。複数を同時に起動しないでください）。

{
  "mcpServers": {
    "rhino": {
      "command": "sh",
      "args": ["-c", "killall rhinomcp 2>/dev/null; uvx rhinomcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "rhino": {
      "command": "cmd",
      "args": ["/c", "taskkill /F /IM rhinomcp.exe 2>nul & uvx rhinomcp@latest"]
    }
  }
}

3. Rhino ブリッジを起動する

Rhino を起動した状態で、コマンドラインに mcpstart と入力します。これにより、サーバーが接続する TCP ブリッジが起動します（mcpstop で停止します）。Rhino セッションごとに 1 回実行してください。

最新の状態を維持する

RhinoMCP は、それぞれ個別に更新される 3 つの部分で構成されています。

• Python サーバー。 uvx rhinomcp@latest は、クライアントがサーバーを起動するたびに PyPI から最新リリースを取得します。通常の uvx rhinomcp は、最初にダウンロードしたバージョンを使い続けます。オフラインで作業する場合は、uv tool install rhinomcp で一度インストールし、都合のよいときに uv tool upgrade rhinomcp を実行してください。
• Rhino プラグイン。 パッケージマネージャーからインストールすると、「Rhino の起動時にパッケージを自動更新する」が有効な場合、Rhino は起動時に更新を確認してインストールします。新しいバージョンは次回の再起動時に読み込まれます。.rhp を Rhino にドラッグしてインストールしたプラグインは更新されません。
• AI クライアント。 サーバーの起動時にツール一覧を読み込むため、更新後はクライアントを再起動するか、サーバーに再接続してください。

サーバーは接続時にプラグインのバージョンを読み取り、2 つのバージョンが異なる場合はログで警告します。新しいプラグインが必要なツールは、何もせず別の動作をするのではなく、更新を促すメッセージを表示して失敗します。また、describe_capabilities は両方のバージョンを報告します。

使用方法

ブリッジを起動し、クライアントを接続すると、RhinoMCP のツールが表示されます。あとはチャットで、何かをモデリングするよう依頼したり、シーンを確認したり、Grasshopper グラフを作成したりできます。

Grasshopper を使う場合は、Rhino を起動して mcpstart を実行するだけです。アシスタントが Grasshopper ドキュメントを開いたり作成したりしてから、定義を構築できます。たとえば、「高さの異なる円柱で、ポイントアトラクターのパターンを作成して」 と依頼できます。

プロンプトの例

原点から 10 単位間隔のグリッド上に 6×6×6 個のボックスを作成し、サイズを 1 から 5 まで段階的に変えてください。サイズに基づいて青から赤へのグラデーションで色を付けてください。RhinoScript Python を使用してください。

立方体ブロックを使って、漫画風の色をしたサイを作成してください。次に、頭を赤に変更し、選択したオブジェクトを Z 軸の周りに 90° 回転してください。

Grasshopper でポイントアトラクターのパターンを作成してください。アトラクターポイントからの距離に応じて高さが変わる円柱のグリッドを作り、ポイントを移動するスライダーも付けてください。

ツールリファレンス

仕組み

AI client ──MCP (stdio)──► rhinomcp (Python) ──TCP 127.0.0.1:1999──► Rhino plugin ──► Rhino + Grasshopper

1. server/：各ツールを公開し、Rhino に転送する Python 製の MCP サーバー（公式 Python SDK 2.x）です。
2. plugin/：Rhino 内で TCP リスナーを実行し、メインスレッド上でコマンドを実行する RhinoCommon C# プラグインです。Rhino コマンド mcpstart / mcpstop で起動・停止します。
3. contracts/：2 つの階層間でワイヤープロトコルの同期を保つ JSON Schema 定義です。

コードの詳細については、IMPLEMENTATION.md をご覧ください。

セキュリティ

Python サーバーと Rhino プラグインは、認証されていない TCP ループバックリンク （127.0.0.1:1999）を介して通信します。run_command、execute_rhinoscript_python_code、 execute_rhinocommon_csharp_code などのツールを使うと、Rhino 内でモデルが自由にコードを実行できます。これはローカルでエージェントを使用する場合には問題ありません。認証を追加せずに、ループバックインターフェースの外部に公開しないでください。

開発者向け

uv venv && uv pip install -e ".[dev]"   # set up
uv run pytest                            # run tests (no Rhino needed; uses a mock server)
uv run ruff check src/rhinomcp           # lint
uv run python ../contracts/test_schemas.py   # validate JSON schemas
uv build && uv publish                   # publish to PyPI

dotnet restore plugin/rhinomcp.sln
dotnet build plugin/rhinomcp.sln --configuration Release

コントリビューション

コントリビューションを歓迎します。お気軽に Issue を作成するか、プルリクエストを送信してください。

免責事項

これはサードパーティ製の統合であり、McNeel によって開発されたものではありません。Jingcheng Chen が開発しました。

スター履歴

サーバーに同梱されているモデリングガイダンス

Python パッケージには、変換、平面領域、整理、検証、復旧に関する再利用可能なガイダンスが含まれています。get_modeling_guidance("overview")、asset_general_strategy MCP プロンプト、または rhinomcp://guidance/{topic} リソースを使用してください。ツールの基本的な動作は、ツールの説明に記載されています。ローカルの実験用フォルダーや、別途スキルを用意する必要はありません。利用可能なトピックとリリースの詳細については、同梱されているガイダンスをご覧ください。