RhinoMCP: Rhino 3D 用 MCP サーバー

Model Context Protocol を介した AI 駆動の 3D モデリング、解析、診断、Grasshopper 統合のための 105 ツール。

RhinoMCP は、基本的なプリミティブから高度なサーフェスモデリング（ロフト、スイープ、回転）、ブール演算、メッシュ診断、ブロック管理、Grasshopper によるパラメトリックデザインまでをカバーする包括的なツールセットを通じて、Claude を Rhino 3D に接続します。

アーキテクチャ

┌────────────────┐   stdio    ┌──────────────┐   TCP/JSON    ┌──────────────┐
│ Claude Desktop │◄──────────►│  rhino_mcp   │◄─────────────►│    Rhino 3D  │
│                │   (MCP)    │  (Python)    │  localhost:   │  listener.py │
│                │            │  server.py   │    9876       │  (inside     │
└────────────────┘            └──────────────┘               │   Rhino)     │
                                                             └──────────────┘

MCP サーバー（rhino_mcp/）。FastMCP を使用した Python パッケージ。stdio を介して Claude と通信し、TCP を介して Rhino と通信します。

Rhino リスナー（rhino/listener.py）。Rhino 内で実行される Python スクリプト。TCP サーバーを開き、JSON コマンドを受信し、RhinoCommon/rhinoscriptsyntax を使用して実行し、結果を返します。

Related MCP server: Grasshopper MCP

機能

ジオメトリ作成（21 ツール）

トランスフォーム（8 ツール）

move, rotate, scale, scale_non_uniform, mirror, copy, array_linear, array_polar

ブール演算（3 ツール）

boolean_union, boolean_difference, boolean_intersection

修正（18 ツール）

ブロックとインスタンス（4 ツール）

create_block, insert_block, list_blocks, explode_block

ユーザーデータ（2 ツール）

set_user_text, get_user_text: メタデータ、BIM データ、コストなどを保存します。

レイヤー（6 ツール）

list_layers, create_layer, delete_layer, set_layer_color, set_layer_visibility, set_current_layer

マテリアル（3 ツール）

list_materials, create_material, assign_material

解析（10 ツール）

診断（4 ツール）

ビュー（5 ツール）

zoom_extents, set_view, capture_view（base64 オプション付き）、list_views, set_display_mode

Grasshopper（3 ツール）

gh_run_script, gh_set_slider, gh_get_outputs

コード実行（2 ツール）

run_python, run_command: rhinoscriptsyntax と RhinoCommon への完全なアクセス

元に戻す/やり直す（2 ツール）

undo, redo

シーン（4 ツール）

scene_info, get_objects, get_object（エッジ情報付きの詳細）、select_objects

インポート/エクスポート（2 ツール）

export（.3dm、.obj、.stl、.step、.iges、.fbx）、import_file

太字 = v2.0 の新機能

前提条件

• Rhino 7 または 8（Windows または Mac）

• Python 3.10+

• uv パッケージマネージャー（インストール）

インストール

1. クローンとインストール

git clone https://github.com/kbangaru-cyber/rhino-mcp.git
cd Rhino_MCP
uv sync

2. Rhino リスナーの起動

Rhino で:

1. ツール > PythonScript > 実行 に移動

2. rhino/listener.py を選択

3. 次のように表示されるはずです:

============================================================
  RhinoMCP Listener v2.0.0
  Listening on 127.0.0.1:9876
  Registered handlers: 90
  Ready for MCP connection (Claude)
============================================================

3. Claude Desktop の設定

Claude Desktop

claude_desktop_config.json を編集:

{
  "mcpServers": {
    "rhino": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/Rhino_MCP", "run", "rhino-mcp"],
      "env": {
        "RHINO_MCP_HOST": "127.0.0.1",
        "RHINO_MCP_PORT": "9876",
        "RHINO_MCP_TIMEOUT": "30"
      }
    }
  }
}

使用例

シンプルな建物フォームを作成

「建物のボリュームとして 10x8x4 メートルのボックスを作成し、中央に半径 2、高さ 6 のシリンダーをタワーとして追加してください。それらを結合し、すべてのエッジに半径 0.3 のフィレットを適用してください。」

モデルの問題を診断

「シーン内のすべてのオブジェクトに問題がないか確認してください。ナaked エッジ（露出エッジ）を見つけて、何を修正する必要があるか教えてください。」

パラメトリックデザイン

「プロファイルカーブを作成して回転させ、花瓶の形状を作成してください。次に、その周りに装飾用シリンダーの極配列を作成してください。」

組み込みプロンプト

RhinoMCP にはガイド付きワークフロープロンプトが含まれています:

• model-from-description: テキスト記述から 3D モデルを作成するための構造化ワークフロー

• diagnose-model: モデルの問題を発見して修正するための体系的なアプローチ

• parametric-design: Grasshopper/パラメトリックワークフローのガイド

リソース

サーバーはライブデータを MCP リソースとして公開します:

設定

開発

# Install dev dependencies
uv sync --extra dev

# Run tests (no Rhino needed)
uv run pytest -v

# Lint
uv run ruff check .

# Type check
uv run mypy rhino_mcp

統合テスト

Rhino が実行され、リスナーがアクティブな状態で:

uv run pytest -v -m integration

プロトコル

コマンドは TCP 経由で送信される JSON オブジェクトです（改行区切り）:

{"id": "abc123", "action": "create_sphere", "params": {"center": [0,0,0], "radius": 5}}

レスポンス:

{"id": "abc123", "ok": true, "result": {"guid": "d3e4f5..."}}

スレッドセーフティ

Rhino リスナーは、Rhino 8+ で Rhino.RhinoApp.InvokeOnUiThread() を使用して、すべてのジオメトリ操作が UI スレッドで実行されるようにします。Rhino 7 では、操作は直接実行されます（単一クライアント接続では安全です）。

ライセンス

MIT。LICENSE を参照してください。

著者

Karthick Raja B G、ポートフォリオ · GitHub

関連プロジェクト: SPIDER、計算ジオメトリと空間解析のための Grasshopper プラグイン。