Grasshopper MCP

Grasshopper MCP 桥接器

Grasshopper MCP Bridge 是一款桥接服务，使用模型上下文协议（MCP）标准连接 Grasshopper 和 Claude Desktop。

功能

• 通过 MCP 协议连接 Grasshopper 和 Claude Desktop
• 提供直观的工具函数，用于创建和连接 Grasshopper 组件
• 支持高级意图识别，可根据简单描述自动创建复杂的组件模式
• 包含组件知识库，可理解常见组件的参数和连接规则
• 提供组件指导资源，帮助 Claude Desktop 正确连接组件

系统架构

系统由以下部分组成：

1. Grasshopper MCP 组件 (GH_MCP.gha)：安装在 Grasshopper 中的插件，提供用于接收命令的 TCP 服务
2. Python MCP 桥接服务：连接 Claude Desktop 和 Grasshopper MCP 组件的桥接服务
3. 组件知识库：包含组件信息、模式和意图的 JSON 文件

安装说明

先决条件

• Rhino 7 或更高版本
• Grasshopper
• Python 3.8 或更高版本
• Claude Desktop

安装步骤

1. 安装 Grasshopper MCP 组件

   方法 1：下载预编译的 GH_MCP.gha 文件（推荐）

   直接从 GitHub 仓库下载 GH_MCP.gha 文件，并将其复制到 Grasshopper 组件文件夹：

   %APPDATA%\Grasshopper\Libraries\
   

   方法 2：从源代码构建

   如果你想从源代码构建，请克隆仓库并使用 Visual Studio 构建 C# 项目。

2. 安装 Python MCP 桥接服务

   方法 1：从 PyPI 安装（推荐）

   最简单的方法是使用 pip 直接从 PyPI 安装：

   pip install grasshopper-mcp
   

   方法 2：从 GitHub 安装

   你也可以从 GitHub 安装最新版本：

   pip install git+https://github.com/alfredatnycu/grasshopper-mcp.git
   

   方法 3：从源代码安装

   如果你需要修改代码或开发新功能，可以克隆仓库并安装：

   git clone https://github.com/alfredatnycu/grasshopper-mcp.git
   cd grasshopper-mcp
   pip install -e .
   

   安装特定版本

   如果你需要安装特定版本，可以使用：

   pip install grasshopper-mcp==0.1.0
   

   或从特定的 GitHub 标签安装：

   pip install git+https://github.com/alfredatnycu/[email protected]
   

用法

1. 启动 Rhino 和 Grasshopper

   启动 Rhino 并打开 Grasshopper。

2. 将 GH_MCP 组件添加到画布

   在 Grasshopper 组件面板中找到 GH_MCP 组件，并将其添加到画布。

3. 启动 Python MCP 桥接服务

   打开终端并运行：

   python -m grasshopper_mcp.bridge
   

   注意：由于 Python 脚本路径问题，命令 grasshopper-mcp 可能无法直接运行。建议使用 python -m grasshopper_mcp.bridge，这种方法更加可靠。

4. 将 Claude Desktop 连接到 MCP 桥接器

   方法 1：手动连接

   在 Claude Desktop 中，使用以下设置连接到 MCP 桥接服务：

   • 协议：MCP
   • 主机：localhost
   • 端口：8080

   方法 2：配置 Claude Desktop 自动启动桥接器

   你可以修改 Claude Desktop 的配置，使其自动启动 MCP 桥接服务：

   "grasshopper": {
     "command": "python",
     "args": ["-m", "grasshopper_mcp.bridge"]
   }
   

   此配置会指示 Claude Desktop 使用命令 python -m grasshopper_mcp.bridge 启动 MCP 服务。

5. 开始使用 Claude Desktop 操作 Grasshopper

   现在，你可以使用 Claude Desktop 通过自然语言命令控制 Grasshopper。

示例命令

以下是一些可在 Claude Desktop 中使用的示例命令：

• “在点 (0,0,0) 处创建一个半径为 5 的圆”
• “将圆连接到高度为 10 的拉伸组件”
• “创建一个包含 5 行和 5 列点的网格”
• “对所有选定对象应用随机旋转”

故障排除

如果遇到问题，请检查以下内容：

1. GH_MCP 组件未加载

   • 确保 .gha 文件位于正确的位置
   • 在 Grasshopper 中，转到 File > Preferences > Libraries，然后单击 “Unblock” 以解除对新组件的阻止
   • 重启 Rhino 和 Grasshopper

2. 桥接服务无法启动

   • 如果 grasshopper-mcp 命令无法使用，请改用 python -m grasshopper_mcp.bridge
   • 确保已安装所有必需的 Python 依赖项
   • 检查端口 8080 是否已被其他应用程序占用

3. Claude Desktop 无法连接

   • 确保桥接服务正在运行
   • 确认使用了正确的连接设置（localhost:8080）
   • 检查桥接服务的控制台输出，查看是否有错误消息

4. 命令未执行

   • 确认 GH_MCP 组件位于 Grasshopper 画布上
   • 检查桥接服务控制台中的错误消息
   • 确保 Claude Desktop 已正确连接到桥接服务

开发

项目结构

grasshopper-mcp/
├── grasshopper_mcp/       # Python bridge server
│   ├── __init__.py
│   └── bridge.py          # Main bridge server implementation
├── GH_MCP/                # Grasshopper component (C#)
│   └── ...
├── releases/              # Pre-compiled binaries
│   └── GH_MCP.gha         # Compiled Grasshopper component
├── setup.py               # Python package setup
└── README.md              # This file

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

致谢

• 感谢 Rhino 和 Grasshopper 社区提供的优秀工具
• 感谢 Anthropic 提供 Claude Desktop 和 MCP 协议

联系方式

如有问题或需要支持，请在 GitHub 仓库中提交 issue。