Grasshopper MCP Bridge Server 使用说明

项目简介

Grasshopper MCP Bridge Server 是一个基于 Model Context Protocol (MCP) 标准构建的桥接服务器，旨在连接 Grasshopper 和 Claude Desktop。它允许用户通过 Claude Desktop 以自然语言指令控制 Grasshopper，实现参数化设计的自动化。

主要功能点

连接 Grasshopper 和 Claude Desktop: 通过 MCP 协议实现 Claude Desktop 与 Grasshopper 的互联互通。
提供直观的工具功能: 为 Claude Desktop 提供了一系列工具，用于在 Grasshopper 中创建、连接和操作组件。
支持高层意图识别: 能够理解用户对复杂组件模式的意图描述，并自动创建相应的 Grasshopper 组件结构。
内置组件知识库: 包含常用 Grasshopper 组件的参数和连接规则知识，辅助 Claude Desktop 正确操作组件。
提供组件指导资源: 为 Claude Desktop 提供组件使用指南，帮助用户理解 Grasshopper 组件的功能和连接方式。

安装步骤

安装 Grasshopper MCP 组件 (GH_MCP.gha)
- 推荐方法: 下载预编译的 'GH_MCP.gha' 文件，并复制到 Grasshopper 组件库文件夹 '%APPDATA%\Grasshopper\Libraries'.
- 或者，您可以选择从源代码编译。
安装 Python MCP Bridge Server
- 推荐方法: 使用 pip 从 PyPI 安装：
```
pip install grasshopper-mcp
```
- 您也可以选择从 GitHub 或源代码安装。

服务器配置

为了让 Claude Desktop 能够连接到 Grasshopper MCP Bridge Server，您需要在 Claude Desktop 的设置中添加 MCP 服务器配置。配置信息为 JSON 格式，示例如下：

{
  "mcpServers": {
    "grasshopper": {
      "command": "grasshopper-mcp",
      "args": []
    }
  }
}

配置参数说明:

'"grasshopper"': 服务器名称，您可以自定义，用于在 Claude Desktop 中标识该服务器连接。
'"command": "grasshopper-mcp"': 启动 Grasshopper MCP Bridge Server 的命令。安装 Python 包后，'grasshopper-mcp' 命令会被添加到您的系统路径中。
'"args": []': 启动命令的参数。在本例中，我们不需要额外的启动参数，所以设置为空列表。

重要提示: 请确保 Claude Desktop 的 MCP 服务器配置中 '"command"' 的值与您安装的 Python 包提供的命令行工具名称一致 ('grasshopper-mcp')。

基本使用方法

启动 Rhino 和 Grasshopper: 确保 Rhino 和 Grasshopper 软件已运行。
启动 Python MCP Bridge Server: 打开终端或命令提示符，运行命令 'grasshopper-mcp' 启动服务器。
配置 Claude Desktop: 在 Claude Desktop 的设置中，添加上述提供的 MCP 服务器配置。
使用 Claude Desktop 与 Grasshopper 交互: 现在您可以使用 Claude Desktop 发送指令来控制 Grasshopper 了。例如：
- 在 Claude Desktop 中输入 '"Create a 3D Voronoi in Grasshopper"'，服务器将尝试在 Grasshopper 中创建相应的组件模式。
- 您可以尝试其他指令，如 '"Add a circle component"', '"Connect the point and circle components"' 等，来测试和使用更多功能。

请参考仓库的 README.md 文件获取更详细的信息和高级用法。

关键词