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

RhinoMCP 通过模型上下文协议 (MCP) 将 Rhino 连接到 Claude AI，使 Claude 能够直接与 Rhino 交互并控制它。这种集成实现了在 Rhino 3D 中进行提示辅助的 3D 建模。

演示

演示 1

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

演示 2

此演示展示了 AI 如何在两个方向上与 Rhino 交互。单击下面的图片观看视频。

功能

• 双向通信：通过基于套接字的服务器将 Claude AI 连接到 Rhino
• 对象操作：在 Rhino 中创建、修改和删除 3D 对象
• 文档检查：获取有关当前 Rhino 文档的详细信息
• 脚本执行：在 Rhino 中执行 Rhinos python 脚本（实验性，可能并非每次都有效）

[!NOTE] 到目前为止，该工具仅支持创建原始对象以进行概念验证。将来会添加更多几何体。 支持的对象：点、线、折线、曲线、盒子、球体

组件

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

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

安装

前提条件

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

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

安装 Rhino 插件

1. 转到工具 > 包管理器
2. 搜索 rhinomcp
3. 点击 安装

安装 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 > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 以包含上述配置文件。

Cursor 集成

确保您的 Cursor 是最新的。

在您的项目根目录中创建一个文件夹 .cursor。

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

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

用法

启动连接

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

与 Claude 一起使用

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

与 Cursor 一起使用

在 Cursor 上设置配置文件并且插件在 Rhino 上运行后，您将在 MCP 服务器前面看到绿色指示器。

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

准备就绪后，使用 Ctrl+I 打开聊天框并开始与 Rhino 聊天。确保您已选择代理模式。

技术细节

通信协议

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

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

限制和安全注意事项

• get_document_info 仅获取最多 10 个对象、图层、材质等，以避免大量数据集压垮 Claude。
• 复杂的操作可能需要分解为更小的步骤

贡献

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

免责声明

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