RhinoMCP - Rhino 模型上下文协议集成

<img src="assets/rhinomcp_logo.svg" alt="RhinoMCP Logo" width="130">

RhinoMCP 通过模型上下文协议（MCP）将 Rhino 连接到 AI 代理，使 AI 代理能够直接与 Rhino 交互并控制它。这种集成使得在 Rhino 3D 中可以进行提示辅助的 3D 建模。

功能

• 双向通信：通过基于套接字的服务器连接 AI 代理到 Rhino
• 对象操作：在 Rhino 中创建、修改和删除 3D 对象
• 文档检查：获取当前 Rhino 文档的详细信息
• 脚本执行：在 Rhino 中执行 Rhinos 的 Python 脚本（实验性，可能并非每次都能成功）
• 获取脚本文档：获取特定 RhinoScript Python 函数的文档
• 对象选择：根据过滤器（例如名称、颜色、类别等）使用“与”或“或”逻辑选择对象
• 设置/创建/删除图层：获取或设置当前图层，创建新图层或删除图层

[!NOTE]
目前该工具仅支持创建基本对象以证明概念。未来将添加更多几何体。 支持的对象：点、线、多段线、圆、弧、椭圆、曲线、盒子、球体、圆锥、圆柱、表面（从点）

演示

演示 1

此演示展示了 AI 如何与 Rhino 进行双向交互。点击下方图片观看视频。

演示 2

此演示展示了如何请求 AI 创建自定义脚本并在 Rhino 中执行它们。点击下方图片观看视频。

教程

感谢 Nate。他为此工具创建了一个展示和安装教程。

组件

系统由两个主要组件组成：

1. MCP 服务器 (src/rhino_mcp_server/server.py)：一个实现模型上下文协议并与 Rhino 插件连接的 Python 服务器
2. Rhino 插件 (src/rhino_mcp_plugin)：一个在 Rhino 内部创建套接字服务器以接收和执行命令的 Rhino 插件

安装

先决条件

• Rhino 7 或更新版本（适用于 Windows 和 Mac）；确保你的 Rhino 是最新版本。
• Python 3.10 或更新版本
• uv 包管理器

⚠️ 只能在 Cursor 或 Claude Desktop 上运行一个实例的 MCP 服务器，不能同时运行两者

安装 Rhino 插件

1. 转到 Tools > Package Manager
2. 搜索 rhinomcp
3. 点击 Install

安装 uv

如果你使用的是 Mac，请按以下方式安装 uv

brew install uv

在 Windows 上

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

⚠️ 在继续之前请务必安装 UV

配置文件

{
  "mcpServers": {
    "rhino": {
      "command": "uvx",
      "args": ["rhinomcp"]
    }
  }
}

Claude for Desktop 集成

转到 Claude > Settings > Developer > Edit Config > claude_desktop_config.json 并包含上述配置文件。

Cursor 集成

确保你的 Cursor 是最新版本。

在项目根目录下创建一个名为 .cursor 的文件夹。

在 .cursor 文件夹中创建一个名为 mcp.json 的文件，并包含上述配置文件：

转到 Cursor 设置 > MCP 并检查是否已启用。

使用方法

启动连接

1. 在 Rhino 中，在命令行中输入 mcpstart
2. 确保 MCP 服务器正在 Rhino 终端上运行

与 Claude 结合使用

一旦在 Claude 上设置了配置文件，并且插件在 Rhino 上运行，你将在 Claude 中看到一个带有工具的锤子图标。

与 Cursor 结合使用

一旦在 Cursor 上设置了配置文件，并且插件在 Rhino 上运行，你将在 Cursor 中看到 MCP 服务器前面的绿色指示灯。

如果未显示，请尝试刷新 Cursor 中的服务器。如果有任何控制台弹出，请不要关闭它。

准备好后，使用 Ctrl+I 打开聊天框并开始与 Rhino 聊天。确保你选择了 Agent 模式。

技术细节

通信协议

系统使用基于 JSON 的简单协议通过 TCP 套接字：

• 命令作为具有 type 和可选 params 的 JSON 对象发送
• 响应是具有 status 和 result 或 message 的 JSON 对象

限制及安全考虑

• get_document_info 只会获取最多 30 个对象、图层、材质等，以避免庞大的数据集淹没 Claude。
• 复杂的操作可能需要分解为更小的步骤

构建工具和发布

构建和发布服务器

cd rhino_mcp_server
uv build
uv publish

构建和发布插件

1. 以 Release 模式构建工具
2. 将 "manifest.yml" 文件复制到 "bin/Release" 文件夹
3. 在 Release 文件夹中运行 yak build
4. 运行 yak push rhino_m_插件_xxxx.yak 发布插件

贡献

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

免责声明

这是一个第三方集成，不是由 Mcneel 制作的。由 Jingcheng Chen 制作

Star 历史