jingcheng-chen/rhinomcp

RhinoMCP – 基于 AI 的 Rhino 3D 与 Grasshopper 控制

是什么 – 一个小型开源桥接工具，允许大型语言模型代理（Claude、Cursor、Codex 等）与 Rhino 3D 及其可视化编程环境 Grasshopper 通信。它实现了 Model Context Protocol（MCP），使 AI 能够以自然语言发出高级命令，并从 Rhino 视口接收视觉反馈。

核心功能

• 几何体创建与编辑 – 点、曲线、曲面、实体、布尔运算、放样、扫掠等，可逐个或批量操作。
• 场景检查 – 查询对象列表、属性、图层，或捕获当前视口的截图，让模型“看见”当前状态。
• Grasshopper 脚本 – 搜索组件、添加到画布、连接参数、设置滑块值、运行求解器，或单次调用重建整个定义。
• 低级访问 – 可运行任何原生 Rhino 命令、执行 RhinoScript-Python 代码，或运行 RhinoCommon C# 代码（可选开关以禁用这些强大工具）。
• 双向交互 – AI 既能生成几何体，也能读取模型状态，支持迭代式设计循环。

工作原理

1. Python MCP 服务器（PyPI 上的 rhinomcp）在本地运行，通过标准 MCP stdio 接口暴露工具集。
2. Rhino 插件（通过 Rhino 的包管理器安装）在 Rhino 内部启动一个 TCP 监听器（默认 127.0.0.1:1999）。
3. AI 客户端将服务器注册为 MCP 端点（rhino），发送 JSON 编码的工具调用；插件在主 Rhino 线程上执行这些调用并返回结果。

快速上手

1. 通过包管理器安装 Rhino 插件（rhinomcp）。
2. 使用 uvx rhinomcp@latest 安装 Python 服务器（或通过 pip install rhinomcp）。
3. 将服务器添加到 AI 客户端的 MCP 配置中（例如：codex mcp add rhino …）。
4. 在 Rhino 中运行命令 mcpstart 以打开 TCP 桥接。
5. 与你的助手聊天：要求它“创建一个 6×6×6 的盒子网格，颜色从蓝色渐变到红色”或“构建一个 Grasshopper 图形，使圆柱体的高度随距离某一点的距离而变化”。

适用人群 – 已使用 Rhino 8 并希望尝试 AI 辅助建模或自动化 Grasshopper 工作流的设计师、建筑师、工程师或开发者。也适用于构建自主设计代理的研究人员。

项目状态 – 活跃维护中（PyPI 发布、通过包管理器更新 Rhino 插件）。仓库包含 Python 测试套件、C# 构建脚本以及扩展工具集的文档。

许可证 – MIT。