GH MCP Server

🚀 GH_mcp_server

GH_mcp_server は、デザイナーが大規模言語モデル（LLMs）を通じて直接 Rhino と Grasshopper を操作する方法を提供します。これには、.3dm ファイルの分析、3D モデリング、ユーザーの指示に基づく Grasshopper の GHPython スクリプトの自動生成が含まれます。

⚠️ 重要提示

このプロジェクトは現在開発中です。皆様のご参加をお待ちしています！

• 問題が発生した場合やアイデアがある場合は、issuesを開く をお気軽に。
• プルリクエスト（Pull Requests）も大歓迎です。
• 長期的な協力に興味がある方は、yizhuod@andrew.cmu.edu までご連絡ください。チームに参加していただけることを楽しみにしています！

📦 インストール

必要条件

• Rhino 7 または 8
• RhinoPython のインストール：https://github.com/jingcheng-chen/RhinoPythonForVscode/tree/master?tab=readme-ov-file
• uv

  • # MacOS と Linux システム
    curl -LsSf https://astral.sh/uv/install.sh | sh
    

  • # Windows システム
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    

• Claude Desktop

インストール手順

1. リポジトリをクローン

git clone git@github.com:veoery/GH_mcp_server.git
cd GH_mcp_server

2. 環境を設定

uv の使用を推奨します。

MacOS/Linux システム

uv venv
source .venv/bin/activate
uv pip install -e .

Windows システム

uv venv
.venv\Scripts\activate
uv pip install -e .

💡 使用建议

プロジェクトを実行または開発する前に、必ず仮想環境をアクティブにしてください。

3. 設定

1. Claude Desktop で、設定 -> 開発者に移動します。編集設定 が表示されます。
2. 編集設定 をクリックし、ファイル claude_desktop_config.json を開きます。
3. 以下のコードを JSON ファイルに追加します。

   {
     "mcpServers": {
       "grasshopper": {
         "command": "path_to_GH_mcp_server/.venv/bin/python",
         "args": [
           "path_to_GH_mcp_server/run_server.py"
         ]
       }
     }
   }
   

4. Claude Desktop を再起動します。ハンマーアイコンが表示されれば、設定は成功です。ハンマーアイコンをクリックして、すべての追加された MCP ツールを確認してください。

💻 使用例

基本的な使用法

1. Rhino を起動します。
2. コマンド CodeListener を入力します。VS Code リスナーが起動しました... というメッセージが表示されるはずです。
3. Claude Desktop を開き、プロンプトを入力して GH_mcp_server ツールと対話します。Grasshopper との対話方法については、ファイル examples\zaha01.gh の例を参考にしてください。以下はいくつかの例です。

   まず、ファイル "D:\test01.3dm" を読み込み、このファイル内のオブジェクトを分析します。
   

   ザハのスタイルを参考に塔を作成し、ghpython コードを "D:\zaha01.py" ファイルに書き込みます。