Grasshopper MCP Bridge

Grasshopper MCP Bridge 是一个通过 Model Context Protocol (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 安装（推荐）

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

   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/grasshopper-mcp.git@v0.1.0
   

使用

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. 开始使用 Grasshopper 和 Claude Desktop

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

示例命令

这里是一些您可以与 Claude Desktop 一起使用的示例命令：

• "创建一个半径为 5 的圆，位于点 (0,0,0)"
• "将圆连接到一个高度为 10 的挤出组件"
• "创建一个有 5 行 5 列的点网格"
• "对所有选定对象应用随机旋转"

故障排除

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

1. GH_MCP 组件未加载

   • 确保 .gha 文件位于正确的位置
   • 在 Grasshopper 中，转到文件 > 首选项 > 库，并点击“解除阻止”以解除新组件的阻止
   • 重新启动 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 桥接服务器
│   ├── __init__.py
│   └── bridge.py          # 主桥接服务器实现
├── GH_MCP/                # Grasshopper 组件（C#）
│   └── ...
├── releases/              # 预编译二进制文件
│   └── GH_M_gha           # 编译的 Grasshopper 组件
├── setup.py               # Python 包设置
└── README.md              # 本文件

贡献

欢迎贡献！请随时提交拉取请求。

许可证

本项目根据 MIT 许可证发布 - 详情见 LICENSE 文件。

致谢

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

联系方式

如有疑问或需要支持，请在 GitHub 仓库上打开一个问题。