Grasshopper 3D

🚀 GH_mcp_server 項目文檔

GH_mcp_server 為設計師提供了一種與 Rhino 和 Grasshopper 直接交互的方法。藉助大語言模型（LLMs），它可以分析 .3dm 文件、進行 3D 建模，還能依據用戶的指導自動生成 Grasshopper 的 GHPython 代碼。

🚀 快速開始

需求

• 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 工具交互。建議參考文件 examples\zaha01.gh 以瞭解如何與 Grasshopper 交互。以下是一些示例：

   首先讀取文件 "D:\test01.3dm" 並分析此文件中的對象。
   

   參考扎哈（Zaha）的風格創建一座塔，並將 ghpython 代碼寫入 "D:\zaha01.py" 文件中。
   

✨ 主要特性

• 允許設計師通過大語言模型（LLMs）直接與 Rhino 和 Grasshopper 進行交互。
• 能夠分析 .3dm 文件、進行 3D 建模。
• 可根據用戶指導自動生成 Grasshopper 的 GHPython 代碼。

📄 許可證

文檔中未提及相關內容，暫不展示。

⚠️ 重要提示

此項目目前仍在開發中——我們歡迎您提供幫助！

💡 使用建議

• 如果您遇到問題或有任何想法，請隨時 打開一個issues。
• 歡迎提交 Pull Request！
• 如果您對長期合作感興趣，歡迎聯繫 yizhuod@andrew.cmu.edu——我們很樂意邀請您加入團隊！