GH_mcp_server

GH_mcp_server 提供了一种方法，允许设计师通过 LLM 直接与 Rhino 和 Grasshopper 交互，包括分析 .3dm 文件、进行 3D 建模以及根据用户的指导在 Grasshopper 中自动生成 GHPython。

本项目仍在建设中——我们非常欢迎您的帮助！

• 如果您遇到错误或有任何想法，请随时提出 issue。
• 随时欢迎提交 Pull Request。
• 如果您有兴趣进行长期合作，请随时联系 yizhuod@andrew.cmu.edu ——我们非常希望您能加入我们的团队！

要求

• Rhino 7 或 8

• 安装 RhinoPython: https://github.com/jingcheng-chen/RhinoPythonForVscode/tree/master?tab=readme-ov-file

• uv

  • # For MacOS and Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    

  • # For 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 中，导航到 Settings->Developer。您将看到 Edit Config。

2. 点击 Edit Config 并打开文件 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 Listener Started...。

3. 打开 Claude Desktop 并输入提示以与 GH_mcp_server 工具交互。另请查看文件 examples\zaha01.gh 作为与 Grasshopper 交互的参考。以下是一些示例：

   首先读取文件 "D:\test01.3dm" 并分析此文件中的对象。
   

   编写 GHpython 来创建一个参考扎哈的塔，并将 ghpython 代码写入 "D:\zaha01.py"