Grasshopper MCP

Grasshopper MCP Bridge

Grasshopper MCP Bridge は、Model Context Protocol（MCP）標準を使用して Grasshopper と Claude Desktop を接続するブリッジサーバーです。

機能

• MCP プロトコルを通じて Grasshopper と Claude Desktop を接続します
• Grasshopper のコンポーネントを作成、接続するための直感的なツール関数を提供します
• 高度な意図認識に対応しており、簡単な説明から複雑なコンポーネントパターンを自動的に作成します
• 一般的なコンポーネントのパラメーターと接続ルールを理解する、コンポーネントのナレッジベースを含みます
• Claude Desktop がコンポーネントを正しく接続できるよう、コンポーネントのガイダンスリソースを提供します

システムアーキテクチャ

システムは次の要素で構成されています。

1. Grasshopper MCP Component (GH_MCP.gha)：コマンドを受信する TCP サーバーを提供する、Grasshopper にインストールするプラグインです
2. Python MCP Bridge Server：Claude Desktop と Grasshopper MCP Component を接続するブリッジサーバーです
3. Component Knowledge Base：コンポーネント情報、パターン、意図を含む JSON ファイルです

インストール手順

前提条件

• Rhino 7 以降
• Grasshopper
• Python 3.8 以降
• Claude Desktop

インストール手順

1. Grasshopper MCP Component をインストールする

   方法 1：コンパイル済みの GH_MCP.gha ファイルをダウンロードする（推奨）

   GitHub リポジトリから GH_MCP.gha ファイルを直接ダウンロードし、Grasshopper のコンポーネントフォルダーにコピーします。

   %APPDATA%\Grasshopper\Libraries\
   

   方法 2：ソースからビルドする

   ソースからビルドする場合は、リポジトリをクローンし、Visual Studio を使用して C# プロジェクトをビルドします。

2. Python MCP Bridge Server をインストールする

   方法 1：PyPI からインストールする（推奨）

   最も簡単な方法は、pip を使用して PyPI から直接インストールすることです。

   pip install grasshopper-mcp
   

   方法 2：GitHub からインストールする

   GitHub から最新バージョンをインストールすることもできます。

   pip install git+https://github.com/alfredatnycu/grasshopper-mcp.git
   

   方法 3：ソースコードからインストールする

   コードを変更する場合や新機能を開発する場合は、リポジトリをクローンしてインストールできます。

   git clone https://github.com/alfredatnycu/grasshopper-mcp.git
   cd grasshopper-mcp
   pip install -e .
   

   特定のバージョンをインストールする

   特定のバージョンをインストールする場合は、次のコマンドを使用します。

   pip install grasshopper-mcp==0.1.0
   

   または、特定の GitHub タグからインストールします。

   pip install git+https://github.com/alfredatnycu/[email protected]
   

使い方

1. Rhino と Grasshopper を起動する

   Rhino を起動して Grasshopper を開きます。

2. GH_MCP Component をキャンバスに追加する

   Grasshopper のコンポーネントパネルで GH_MCP コンポーネントを見つけ、キャンバスに追加します。

3. Python MCP Bridge Server を起動する

   ターミナルを開いて、次のコマンドを実行します。

   python -m grasshopper_mcp.bridge
   

   注：Python スクリプトのパスに関する問題により、grasshopper-mcp コマンドが直接動作しない場合があります。python -m grasshopper_mcp.bridge を使用する方法が推奨されており、より確実です。

4. Claude Desktop を MCP Bridge に接続する

   方法 1：手動で接続する

   Claude Desktop で、次の設定を使用して MCP Bridge サーバーに接続します。

   • プロトコル：MCP
   • ホスト：localhost
   • ポート：8080

   方法 2：Bridge を自動起動するよう Claude Desktop を設定する

   設定を変更すると、MCP Bridge サーバーを自動的に起動するよう Claude Desktop を設定できます。

   "grasshopper": {
     "command": "python",
     "args": ["-m", "grasshopper_mcp.bridge"]
   }
   

   この設定により、Claude Desktop は python -m grasshopper_mcp.bridge コマンドを使用して MCP サーバーを起動します。

5. Claude Desktop で Grasshopper の使用を開始する

   自然言語のコマンドを使用して、Claude Desktop から Grasshopper を操作できるようになります。

コマンド例

Claude Desktop で使用できるコマンドの例を以下に示します。

• 「半径 5 の円を点（0,0,0）に作成して」
• 「円を高さ 10 の押し出しコンポーネントに接続して」
• 「5 行 5 列の点のグリッドを作成して」
• 「選択したすべてのオブジェクトにランダムな回転を適用して」

トラブルシューティング

問題が発生した場合は、以下を確認してください。

1. GH_MCP コンポーネントが読み込まれない

   • .gha ファイルが正しい場所にあることを確認してください
   • Grasshopper で、File > Preferences > Libraries に移動し、「Unblock」をクリックして新しいコンポーネントのブロックを解除してください
   • Rhino と Grasshopper を再起動してください

2. ブリッジサーバーが起動しない

   • grasshopper-mcp コマンドが動作しない場合は、代わりに python -m grasshopper_mcp.bridge を使用してください
   • 必要な Python の依存関係がすべてインストールされていることを確認してください
   • ポート 8080 が別のアプリケーションによってすでに使用されていないか確認してください

3. Claude Desktop が接続できない

   • ブリッジサーバーが実行中であることを確認してください
   • 正しい接続設定（localhost:8080）を使用していることを確認してください
   • ブリッジサーバーのコンソール出力にエラーメッセージがないか確認してください

4. コマンドが実行されない

   • GH_MCP コンポーネントが Grasshopper のキャンバス上にあることを確認してください
   • ブリッジサーバーのコンソールにエラーメッセージがないか確認してください
   • Claude Desktop がブリッジサーバーに正しく接続されていることを確認してください

開発

プロジェクト構成

grasshopper-mcp/
├── grasshopper_mcp/       # Python bridge server
│   ├── __init__.py
│   └── bridge.py          # Main bridge server implementation
├── GH_MCP/                # Grasshopper component (C#)
│   └── ...
├── releases/              # Pre-compiled binaries
│   └── GH_MCP.gha         # Compiled Grasshopper component
├── setup.py               # Python package setup
└── README.md              # This file

コントリビューション

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

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

謝辞

• 優れたツールを提供してくださった Rhino および Grasshopper コミュニティに感謝します
• Claude Desktop と MCP プロトコルを提供してくださった Anthropic に感謝します

お問い合わせ

質問やサポートが必要な場合は、GitHub リポジトリで issue を作成してください。