Rhino MCP

面向 Codex、Claude 和 Cursor 的低摩擦 Rhino 与 Grasshopper 桥接工具。

Windows 体验刻意保持简短：

1. 下载并运行 RhinoMCP-Windows-Setup。

2. 选择 Codex、Claude 或 Cursor。

3. 打开 Rhino，打开 Grasshopper，然后开始提问。

正常安装流程中不涉及 Rhino Package Manager、仓库克隆、Python 安装、uv、Conda 环境、Rhino Python 脚本、Grasshopper 文件、Python 路径修改、终端命令或手动编辑的 MCP 配置。

安装

需要 Rhino 8.0 或更高版本，以及你想使用的 AI 客户端。Rhino 8.1 无需更新 Rhino 即可支持。 关闭 Rhino，从最新发布下载 单个 RhinoMCP-Windows-Setup-*.exe 文件，然后双击运行。安装程序会询问 AI 客户端，然后自动：

• 使用 Rhino 自带的安装程序安装 Rhino 和 Grasshopper 桥接；

• 安装一个自带完整运行时的独立 MCP 服务器；

• 安全地写入 Codex、Claude 或 Cursor 的 MCP 条目；

• 选择安全的 Grasshopper 工具配置文件；

• 运行 doctor 检查；以及

• 在 Windows 已安装的应用中添加一个常规条目，以便干净卸载。

安装程序不需要 Rhino 在线，不下载依赖项，Rhino MCP 也从不自我更新。 安装不同版本始终需要手动运行另一个安装程序。

对于托管或静默部署，同一下载支持：

.\RhinoMCP-Windows-Setup-0.3.3.exe /CLIENT=codex /SILENT

有效的客户端值为 codex、claude 和 cursor。设置完成后重启所选的 AI 客户端。Codex 用户可以运行 /mcp 来确认 rhino-mcp 已启用。

Related MCP server: Grasshopper MCP

Rhino 中会出现什么

可停靠的 Rhino MCP 面板会在每次 Rhino 启动时自动打开。它会一直保持可见， 直到用户将其隐藏；隐藏后在该会话的剩余时间内保持隐藏，并在下次 Rhino 启动时再次出现。 随时运行 RhinoMCP 命令可手动显示或隐藏它。

该面板会嵌入 Rhino 正常的面板/标题栏区域。其标题显示 已连接 — 可随时向 Rhino 提问、 Rhino MCP 正在运行 — 等待 AI 客户端，或一条可操作的已停止/未配置消息。它还显示：

• MCP 服务器已连接或等待中

• Rhino 桥接已连接或已停止

• Grasshopper 可用或未运行

• 所选的 AI 客户端和工具配置文件

• Rhino 和 Grasshopper 端口

• 最近的日志

• 重启、创建测试立方体和 复制 doctor 命令按钮

安装程序包含两个 Rhino 8 运行时构建。Rhino 会在正常运行时自动使用 net7.0，如果 Rhino 配置为旧版 .NET Framework 运行时则使用 net48；用户无需选择或配置。

连接测试会创建一个一单位立方体，验证它，然后将其移除。如果禁用了清理， 测试立方体会保留在文档中。

高级命令

Rhino 面板的 复制 doctor 命令按钮会为安装程序用户复制正确的完整路径。 源码和 Python 包安装可以使用：

rhino-mcp setup [codex|claude|cursor]
rhino-mcp doctor [--json]
rhino-mcp status [--json]
rhino-mcp update
rhino-mcp uninstall [--all]
rhino-mcp config [codex|claude|cursor]
rhino-mcp config --profile basic|grasshopper|developer

doctor 会报告包、设置、每个 AI 客户端、Rhino、Grasshopper 和服务启动器的 通过/失败/等待状态。Rhino 和 Grasshopper 关闭时显示为 WAIT，并给出确切的下一个操作， 而不是显示套接字跟踪。

工具配置文件

基本（默认）

安全日常工具集：

• rhino_status

• get_scene_summary

• list_layers

• list_objects

• get_scene_changes

• create_geometry

• modify_objects

• delete_objects

• organize_layers

• batch_geometry

• test_connection

• capture_viewport

Grasshopper

添加分页的定义上下文、选中/对象检查和重新计算工具。 捆绑的 .gha 会在 Grasshopper 打开时自动启动其桥接；无需加载 .gh 定义或 Python 组件。

开发者

显式添加任意的 Rhino 和 Grasshopper Python 工具。这些工具不在基本和 Grasshopper 工具模式中，因此 AI 客户端无法意外发现或调用它们。仍然优先使用安全的高级操作。

安全编辑行为

• 每个修改请求都会获得一个命名的 Rhino 撤销记录。

• 批处理会在一个事务中执行所有操作，并只重绘一次。

• 几何体和图层工具接受 dry_run: true 用于验证和预览。

• 删除操作需要显式的 Rhino 对象 ID。

• 读取结果是结构化对象，而不是字符串内编码的 JSON。

• 对象和 Grasshopper 列表会被过滤和分页。

• get_scene_changes 只发送自提供的场景版本以来的新增、编辑和删除。

示例提示：

Create a 10 × 8 × 3 box on a layer named Massing. Dry-run it first, then create it
and show me a compressed viewport capture.

可靠性和性能

• 4 字节长度前缀消息取代了旧的巨大接收缓冲区。

• 请求以有界的 64 KiB 块读取，硬限制为 64 MiB。

• Rhino TCP 和 Grasshopper HTTP 连接保持活动并复用。

• 失败的安全读取会自动重连一次。

• 变更操作绝不会盲目重试，防止重复几何体。

• 短生命周期的场景元数据会被缓存，并在编辑后失效。

• 场景变更和大文档会分页，而不是反复完整返回。

• Grasshopper 上下文默认简化。

• 视图捕获默认使用压缩 JPEG，并具有可配置的大小和质量。

• 套接字工作和图像编码在 Rhino 的 UI 线程之外运行；只有 Rhino API 调用会被编组到该线程上。

• 工具描述和正常响应刻意保持紧凑，以减少模型 token 使用量。

使用以下命令更改图像默认值：

rhino-mcp config --image-size 1280 --image-quality 82

开发者构建

Python 包：

python -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q
python -m build

Rhino 8 插件和 Package Manager 存档：

./scripts/build-yak.sh Release

该脚本会在 dist/ 下构建 RhinoMCP.rhp、RhinoMCP.Grasshopper.gha 和一个 .yak。

完整的 Windows 安装程序（在 Windows 上的 PowerShell 中运行）：

python -m pip install -e ".[dev]" "pyinstaller==6.22.2"
choco install innosetup --yes
.\scripts\build-windows-installer.ps1

CI 会编译并对捆绑的 Windows 可执行文件和单文件安装程序进行冒烟测试。 带标签的发布会附加安装程序、其 SHA-256 校验和以及手动开发者工件。

架构

Codex / Claude / Cursor
        │ MCP stdio
        ▼
bundled rhino-mcp.exe
        │ framed, persistent localhost TCP
        ▼
RhinoMCP.rhp ── Rhino document + dockable panel
        │
        └── RhinoMCP.Grasshopper.gha (persistent localhost HTTP)

两个桥接都只绑定到 127.0.0.1；它们不会暴露到网络。

许可证

MIT。此仓库是独立的，没有上游 Git 远程。