Grasshopper 3D

🚀 GH_mcp_server プロジェクトドキュメント

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

⚠️ 重要提示

このプロジェクトは現在開発中です。皆様のご協力を歓迎します！

• 問題が発生した場合やアイデアがある場合は、issuesを開く をお気軽に！
• Pull Requestの送信も大歓迎です！
• 長期的な協力に興味がある方は、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" を読み取り、このファイル内のオブジェクトを分析します。

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