Grasshopper 3D

Grasshopper 3D

🚀 GH_mcp_server

GH_mcp_server 提供了一种让设计师借助大语言模型(LLMs)直接与 Rhino 和 Grasshopper 交互的方法。它支持分析 .3dm 文件、进行 3D 建模,还能依据用户指导自动生成 Grasshopper 的 GHPython 代码。

🚀 快速开始

需求

安装步骤

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" 文件中。

⚠️ 重要提示

此项目目前仍在开发中——我们欢迎您提供帮助!

💡 使用建议

  • 如果您遇到问题或有任何想法,请随时 打开一个issues
  • 欢迎提交 Pull Request!
  • 如果您对长期合作感兴趣,欢迎联系 yizhuod@andrew.cmu.edu——我们很乐意邀请您加入团队!

  • 0 关注
  • 0 收藏,13 浏览
  • system 提出于 2025-09-30 19:57

相似服务问题