rhinomcp | 通往MCP之路

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

RhinoMCP 通过模型上下文协议（Model Context Protocol, MCP）将 Rhino 与 AI 代理连接，使 AI 代理能够直接与 Rhino 交互并控制 Rhino。该集成实现了在 Rhino 3D 中进行提示辅助的 3D 建模。

功能

双向通信：通过基于 Socket 的服务器连接 AI 代理与 Rhino

对象操作：在 Rhino 中创建、修改和删除 3D 对象

文档检查：获取当前 Rhino 文档的详细信息

脚本执行：在 Rhino 中执行 RhinoPython 脚本（实验性功能，可能无法每次成功）

获取脚本文档：获取特定 RhinoScript Python 函数的文档

对象选择：基于过滤器（如名称、颜色、类别等）选择对象，支持“与”或“或”逻辑

设置/创建/删除图层：获取或设置当前图层，创建新图层或删除图层

[!NOTE]目前该工具仅支持创建基础几何体以进行概念验证。未来将添加更多几何体支持。支持的对象：点、线、多段线、圆、圆弧、椭圆、曲线、长方体、球体、圆锥体、圆柱体、曲面（基于点生成）

演示

演示 1

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

View on Smithery

演示 2

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

View on Smithery

教程

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

组件

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

MCP 服务器 (src/rhino_mcp_server/server.py)：一个实现模型上下文协议的 Python 服务器，用于连接 Rhino 插件

Rhino 插件 (src/rhino_mcp_plugin)：一个 Rhino 插件，在 Rhino 内创建 Socket 服务器以接收和执行命令

安装

先决条件

Rhino 7 或更新版本（支持 Windows 和 Mac）；请确保您的 Rhino 已更新至最新版本

Python 3.10 或更新版本

uv 包管理器

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

安装 Rhino 插件

进入工具 > 包管理器

搜索 rhinomcp

点击 安装

安装 uv

如果您使用的是 Mac，请通过以下命令安装 uv：

在 Windows 上：

⚠️ 在安装 uv 之前请勿继续

配置文件

Claude Desktop 集成

进入 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，并包含上述配置文件。

Cursor 集成

确保您的 Cursor 已更新至最新版本。

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

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

进入 Cursor 设置 > MCP，检查是否已启用。

使用

启动连接

!RhinoMCP 命令行

在 Rhino 中，在命令行输入 mcpstart

确保 MCP 服务器在 Rhino 终端中运行

与 Claude 一起使用

在 Claude 中设置好配置文件并启动 Rhino 插件后，您将看到一个带有 RhinoMCP 工具的锤子图标。

!RhinoMCP 在 Claude 中

与 Cursor 一起使用

在 Cursor 中设置好配置文件并启动 Rhino 插件后，您将在 MCP 服务器前看到绿色指示器。

!RhinoMCP 在 Cursor 中

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

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

!RhinoMCP 在 Cursor 中

技术细节

通信协议

该系统使用基于 TCP Socket 的简单 JSON 协议：

命令作为带有 type 和可选 params 的 JSON 对象发送

响应是带有 status 和 result 或 message 的 JSON 对象

限制与安全注意事项

get_document_info 仅获取最多 30 个对象、图层、材质等，以避免大量数据使 Claude 过载

复杂操作可能需要分解为多个小步骤

构建与发布工具

构建与发布服务器

构建与发布插件

在 Release 模式下构建工具

将 "manifest.yml" 文件复制到 "bin/Release" 文件夹

在 Release 文件夹中运行 yak build

运行 yak push rhino_mcp_plugin_xxxx.yak 发布插件

贡献

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

免责声明

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

Star 历史

View on Smithery