Rhino

RhinoMCP

用自然语言通过 AI 控制 Rhino 3D 和 Grasshopper。

RhinoMCP 通过模型上下文协议将 Rhino 连接到 AI Agent， 让 Claude 和 Cursor 等助手只需通过聊天，就能为你创建几何体、读取文档并构建 Grasshopper 定义。

快速开始 · 功能介绍 · 使用方法 · 示例 · 工具参考

English · 简体中文

亮点

如需开展自主改进实验，请先阅读 后续指南。

• 描述你的需求，助手就会在 Rhino 中为你创建。
• 它会读取你的文档并截取视口，因此能根据屏幕上实际显示的内容进行操作。
• 它会为你编写 Grasshopper 脚本：查找组件、连接组件、设置滑块并求解。
• 一个插件和一条配置项即可同时支持 Rhino 和 Grasshopper。
• 需要更多控制时，它可以运行原生 Rhino 命令、RhinoScript-Python 或 RhinoCommon C#。

说明

RhinoMCP 面向 Windows 和 macOS 上的 Rhino 8。

演示

想看完整介绍？Nate 制作了演示视频和安装教程。

功能介绍

Rhino

Grasshopper

快速开始

分为三个步骤：安装 Rhino 插件、连接 AI 客户端，然后在 Rhino 中启动桥接程序。

1. 安装 Rhino 插件

在 Rhino 中打开 工具 → 包管理器，搜索 rhinomcp，然后点击 安装。重启 Rhino。

2. 连接 AI 客户端

选项 A：让 AI 助手为你安装（推荐）

如果你使用 Agent 式助手（Codex、Claude Code、Cursor、Cline 等），请粘贴此提示词：

Please install https://github.com/jingcheng-chen/rhinomcp as a local MCP server named `rhino`.

选项 B：安装 MCP 服务或手动编辑配置

Codex，一条命令：

codex mcp add rhino --env RHINO_MCP_HOST=127.0.0.1 -- uvx rhinomcp@latest

Claude Code，一条命令：

claude mcp add rhino -- uvx rhinomcp@latest

**ChatGPT：**使用上面的 Codex 本地设置。ChatGPT 应用／MCP 连接器目前连接的是远程 MCP 服务，而非 uvx rhinomcp 这类本地 stdio 命令。如果想围绕 RhinoMCP 构建 ChatGPT 应用，请使用 ChatGPT 开发者模式，并配置远程或隧道 MCP 端点。

你也可以手动编辑配置：

{
  "mcpServers": {
    "rhino": {
      "command": "uvx",
      "args": ["rhinomcp@latest"],
      "env": {
        "RHINO_MCP_HOST": "127.0.0.1"
      }
    }
  }
}

重要

启动器 uvx 来自 uv。如果尚未安装： macOS brew install uv · Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

每次只运行一个 RhinoMCP 服务（Codex、Claude、Cursor 等，不能同时运行多个）。

{
  "mcpServers": {
    "rhino": {
      "command": "sh",
      "args": ["-c", "killall rhinomcp 2>/dev/null; uvx rhinomcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "rhino": {
      "command": "cmd",
      "args": ["/c", "taskkill /F /IM rhinomcp.exe 2>nul & uvx rhinomcp@latest"]
    }
  }
}

3. 启动 Rhino 桥接

打开 Rhino 后，在命令行中输入 mcpstart。这会启动服务连接所需的 TCP 桥接（运行 mcpstop 可停止）。每次 Rhino 会话运行一次即可。

保持最新

RhinoMCP 包含三个分别更新的部分：

• Python 服务。 uvx rhinomcp@latest 会在客户端每次启动服务时向 PyPI 查询最新版本；普通的 uvx rhinomcp 则会保留首次下载的版本。如果你需要离线工作，可使用 uv tool install rhinomcp 安装一次，并在方便时运行 uv tool upgrade rhinomcp。
• Rhino 插件。 通过 Package Manager 安装后，Rhino 会在启动时检查更新；启用“Automatically update packages when Rhino starts”后，Rhino 会安装更新，新版本将在下次重启时加载。通过将 .rhp 拖入 Rhino 安装的插件不会更新。
• AI 客户端。 客户端会在启动服务时读取工具列表，因此更新后请重启客户端（或重新连接服务）。

服务连接时会读取插件版本；如果两者版本不同，会在日志中发出警告。需要较新插件的工具会提示更新，而不是悄悄执行其他操作；describe_capabilities 会报告这两个版本。

使用方法

桥接已运行且客户端已连接后，你会看到 RhinoMCP 工具。接下来只需聊天：让助手建模、检查场景，或构建 Grasshopper 图。

对于 Grasshopper，只需打开 Rhino 并运行 mcpstart。助手可以自行打开或创建 Grasshopper 文档，然后构建定义。例如：“创建一个点吸引子图案，使用高度各异的圆柱体。”

示例提示词

从原点开始，在间距为 10 个单位的网格上创建 6×6×6 个方块，尺寸从 1 递增到 5，并根据尺寸为方块着色，颜色从蓝色渐变到红色。使用 RhinoScript Python。

用立方体块拼出一只卡通风格、色彩鲜艳的犀牛。然后将它的头改成红色，并将选中的对象绕 Z 轴旋转 90°。

在 Grasshopper 中创建一个点吸引子图案：生成一个圆柱体网格，其高度随它们与吸引子点的距离变化，并添加一个用于移动该点的滑块。

工具参考

工作原理

AI client ──MCP (stdio)──► rhinomcp (Python) ──TCP 127.0.0.1:1999──► Rhino plugin ──► Rhino + Grasshopper

1. server/：一个 Python MCP 服务（官方 Python SDK 2.x），用于公开每个工具并将其转发到 Rhino。
2. plugin/：一个 RhinoCommon C# 插件，在 Rhino 内运行 TCP 监听器，并在主线程上执行命令。使用 Rhino 命令 mcpstart / mcpstop 启动和停止它。
3. contracts/：JSON Schema 定义，用于确保两层之间的线协议保持同步。

IMPLEMENTATION.md 对代码有更深入的介绍。

安全

Python 服务和 Rhino 插件通过未经身份验证的 TCP 回环链路 （127.0.0.1:1999）通信。run_command、execute_rhinoscript_python_code 和 execute_rhinocommon_csharp_code 等工具会向模型开放 Rhino 内部的执行接口。这适用于本地 Agent。未添加身份验证前，请勿将其暴露到回环接口之外。

面向开发者

uv venv && uv pip install -e ".[dev]"   # set up
uv run pytest                            # run tests (no Rhino needed; uses a mock server)
uv run ruff check src/rhinomcp           # lint
uv run python ../contracts/test_schemas.py   # validate JSON schemas
uv build && uv publish                   # publish to PyPI

dotnet restore plugin/rhinomcp.sln
dotnet build plugin/rhinomcp.sln --configuration Release

贡献

欢迎贡献。欢迎提交问题或拉取请求。

免责声明

这是第三方集成，并非由 McNeel 制作。由 Jingcheng Chen 构建。

Star 历史

随服务分发的建模指南

Python 包包含可重复使用的变换、平面区域、组织、验证和恢复指南。使用 get_modeling_guidance("overview")、 asset_general_strategy MCP 提示词，或 rhinomcp://guidance/{topic} 资源。 基本工具语义保留在工具描述中。无需本地实验文件夹或单独的技能。有关可用主题和发布详情，请参阅打包的指南。