A3D—2026 / RESEARCH SEC.00 — 核心结论 SCROLL 000%
Text → Geometry — 从语言到几何

AI 驱动
3D 建模 CODEX × RHINO / GRASSHOPPER — 建模研究报告

让 Codex 通过 MCP 工具调用直接控制 Rhino 与 Grasshopper,而不是让模型「想象」建模结果。核心命题:从一次性自动建模,转向受控、可迭代、可接管的人机协同工作流。

DocA3D-2026-R1
Field建筑 / 景观 / 规划 / 室内
RouteCodex + MCP + RhinoMCP
Status早期可实验 · 部分可生产辅助
SCROLL
SEC.00Core Findings

五条核心结论Five Key Findings

00
01

最可行路线:Codex + MCP + RhinoMCP 插件

通过工具调用直接控制 Rhino 与 GH,形成「需求 → 分解 → 建图 → 预览 → 迭代 → 导出」的闭环,而非让模型凭空想象几何。

02

Grasshopper 参数化是建筑领域主路线

相比纯 NURBS 单次建模,GH 天然适合规则、约束、批量变体,以及城市 / 景观 / 立面 / 空间单元的生成。

03

能力边界:能自动化局部,不能替代判断

可做脚本化几何、参数化定义、批量变体、简单分析;尚不能稳定完成完整设计判断、规范校核、施工级 BIM、复杂拓扑修复与高可靠曲面连续性控制。

04

生态成熟度:早期可实验,部分可生产辅助

2026 年已有可用的 Rhino MCP / Grasshopper MCP 与官方平台文档,但距「一句话生成高质量建筑方案模型」仍有明显差距。

05

研究路线:先做受控工作流,不追求一步到位

文本需求 → Codex 分解 → 生成 / 修改 GH 图 → Rhino 预览 → 反馈迭代 → 导出 3DM / 图纸 / 分析数据。

SEC.01Driving Modes

四条路径驱动 RhinoFour Ways to Drive Rhino — A / B / C / D

01
CODEX / CLAUDE / CURSOR
PYTHON MCP SERVER
RHINO 插件
RHINOCOMMON / GH
A

通过 MCP 控制 Rhino 插件

RhinoMCP / Rhino MCP Platform · 当前最推荐

AI 读写 Rhino 文档、创建几何、构建 GH 定义:创建对象、布尔、loft、extrude、sweep、offset、pipe、图层管理、视口截图、执行 RhinoScript Python / RhinoCommon C#。

适合 / FIT
  • 点线面体、简单曲面创建
  • 批量体块、阵列、立面构件
  • 移动旋转缩放、命名分层
  • GH 组件搜索、放置、连线、求解
局限 / LIMIT
  • 复杂曲面与脏几何修复不稳定
  • 接口太底层易生成不可执行操作
  • 需可视反馈,否则误判场景状态
  • 大模型上下文爆炸,需摘要过滤
B

生成并执行 Rhino Python 脚本

IronPython 2.7 / CPython 3.9 · Rhino 8 内嵌

Codex 按自然语言生成脚本:rhinoscriptsyntax 快速建几何,RhinoCommon 构造 NURBS 曲线、Brep、Mesh,再根据错误日志或视口反馈迭代修正。

适合 / FIT
  • 快速生成概念体块
  • 规律性几何:楼层、窗格、栏杆
  • 批量命名、分层、测量、导出
  • 重复操作脚本化
局限 / LIMIT
  • API 庞大,模型容易误用
  • 对容差、方向、闭合性敏感
  • 专业可编辑 NURBS 曲面很难生成
  • 常需人工或二次 agent 修正
C

Rhino.Compute / Hops / REST API

官方几何计算服务 · HTTP/HTTPS

Compute 是 McNeel 官方 web server,用 Rhino 几何引擎处理请求;Hops 把外部函数或 GH 文件作为远程 / 本地函数调用。

适合 / FIT
  • GH 定义封装成可调用函数
  • 批量跑方案变体
  • 云端 / 服务器端生成
  • 为网页与后端提供几何计算
局限 / LIMIT
  • 部署复杂度高于本机插件
  • 生产服务器 core-hour 计费
  • macOS 受限,主要兼容 Win/Linux
  • 适合已定流程,不适合自由对话建模
D

离线生成 3DM 文件

rhino3dm / openNURBS · 不开 Rhino 读写 3DM

rhino3dm.py / .js / .NET 跨平台读写 3DM(CPython 3.7–3.11),适合文件层操作与轻量数据交换。

适合 / FIT
  • 批量生成简单 3DM 文件
  • Web / 服务端生成几何数据
  • 与 Three.js / Babylon.js 结合
  • 轻量数据交换
局限 / LIMIT
  • 不是完整 Rhino 几何内核
  • 布尔、相交、复杂曲面不适用
  • 无法承担 GH 求解
  • 不宜作为主要 AI 建模内核
SEC.01.2Grasshopper

GH 的三类 AI 驱动Three Ways to Drive Grasshopper

A

MCP 直接构建 GH 画布

搜索 / 添加组件 · 连线 · 求解

RhinoMCP 的 GH 工具:搜索组件、添加、连线、设参、运行 solution、读取警告、批量 build / mutate graph。适合参数化体块生成器、点吸引、塔楼、立面、遮阳、铺装——输出可被建筑师继续编辑的 GH 定义。

B

GH Python / C# 脚本组件

Script-Mode / SDK-Mode · 少而稳

把复杂逻辑压缩进一个脚本组件,slider / panel 输入参数,输出 Curve / Brep / Mesh / DataTree。比大量连线更稳、更符合 Codex 写代码的长项;代价是可视化语义弱、组件过大易成黑盒。

C

Ant 等专用 GH AI 插件

GH 内置 Copilot · Ask / Build 双模式

2026 年出现的 GH 专用 AI 插件:内置聊天、上下文感知,Ask 解释调试、Build 生成修改定义与脚本,兼容 Rhino 7/8。更像「Grasshopper 内置副驾驶」,不一定依赖 Codex。

SEC.01.3Beyond Rhino

其他软件简要现状Ecosystem Beyond Rhino

BLBlender

生态最活跃(blender-mcp)。适合 mesh、渲染、动画与资产管线;不适合严肃 NURBS / B-Rep 建筑精度工作。

RVRevit

已有 revit-mcp 等项目。偏 BIM 构件、族、参数与审查;落地价值高但语义复杂,适合查询与批量改参,不适合自由形体。

FCFreeCAD / CadQuery

开源参数化 B-Rep,偏机械 / 产品 CAD。适合研究「文本到可执行参数化 CAD」的底层范式;建筑生态不如 Rhino/GH。

SUSketchUp

有社区 MCP 尝试。适合快速体块草模;精确参数化与 NURBS 能力有限,AI 研究深度暂不如 Rhino/GH。

SEC.02Prerequisites

跑通之前需要什么Environment · Hardware · License · Model

02

最低软件环境

Baseline
  • Rhino 8,Windows 优先;macOS 可实验但生态较弱
  • Grasshopper(Rhino 8 内置)
  • Codex CLI / Desktop,MCP 已开启
  • Python 3.10+ 或 uv / uvx
  • Rhino MCP / RhinoMCP 插件
  • 可用的 LLM API 或本地模型服务

路线 A · 官方 MCP Platform

Route A — Fastest
  • Rhino 8 → PackageManager 安装 Rhino-MCP-Platform
  • Rhino 内运行 MCPConnect 获取配置
# ~/.codex/config.toml [mcp_servers.rhino] command = "rhino-mcp-router" args = ["--default-version", "8"]
  • 适合快速跑通研究原型

路线 B · 开源 RhinoMCP

Route B — Hackable
  • Package Manager 安装 rhinomcp + uv
  • Rhino 中运行 mcpstart
# 注册 MCP server codex mcp add rhino \ --env RHINO_MCP_HOST=127.0.0.1 \ -- uvx rhinomcp
  • AI → MCP stdio → Python server → TCP :1999 → Rhino C# 插件;适合二次开发建筑专用工具层
SEC.02.3Hardware
维度Rhino 8 官方建议AI × Rhino 研究推荐
CPUIntel/AMD 64 位(不支持 ARM)现代 8 核以上,跑 GH 大量变体更舒服
RAM8GB+32GB 起步;复杂 GH / 多软件并行建议 64GB
GPUOpenGL 4.5,4GB+ 显存视口独显;本地视觉模型 / LLM 建议 NVIDIA 12–24GB+ VRAM
磁盘5GB(Mac 10GB)SSD,项目缓存与依赖较多
显示强烈建议双屏:一屏 Rhino/GH,一屏 Codex/文档
本地 LLM7B–14B:8–16GB VRAM;30B+:24GB+ 更现实;复杂任务仍不如云端 frontier 模型

Rhino 必须正版吗?

License — Yes
  • 结论:研究应使用正版或官方试用版。
  • EULA 明确授权使用而非出售,并限制并发用户
  • 官方 90 天 Evaluation 可完整试用,到期后保存与插件停止工作
  • MCP / GH 插件依赖正常加载、保存、脚本执行;非授权环境带来不稳定与法律风险
  • Rhino.Compute 本地开发可用现有 license;生产服务器涉及 core-hour billing

模型要求与选择

Model — MCP 是开放协议
  • 不必须 OpenAI / Claude:Codex、Claude、Gemini CLI、Copilot、Cursor、本地 LLM 皆可驱动
  • 能力要求:强代码生成、强工具调用、长上下文、空间推理、视觉能力、稳定遵循约束
  • 首选:GPT-5.x / Codex 系列、Claude Sonnet/Opus 级、Gemini 高阶
  • 可试:Qwen、DeepSeek、GLM、Kimi、Mistral、Llama 等
  • 不建议:小模型直接写复杂几何脚本,除非 MCP 工具封装得足够高层
SEC.03GH vs NURBS

参数化,还是直接建模Parametric vs Direct Modeling

03
Verdict / 判断

Grasshopper 是 Codex × Rhino AI 建模的主战场

建筑任务多为规则驱动:楼层、开间、立面网格、遮阳、退界、指标。GH 把一次生成变成可调参数系统,建筑师可用 slider 接管;方案研究需要的大量变体,也只有 GH 适合批量生成。

However / 但非全部

NURBS 直接建模仍有其位

快速体块草模、明确几何的批量生成、图层清理与测量、局部对象处理——直接建模更快。GH 定义过大过乱时,AI 维护同样会变困难。

维度Rhino / NURBS 直接建模Grasshopper 参数化
输出直接几何对象可复用参数化定义 + 几何预览
交互命令 / 脚本 / 对象编辑组件图 / 脚本组件 / slider
可编辑性后期多靠手动修改对象后期通过参数和图逻辑修改
可复用性中等,脚本可复用高,GH 文件即设计系统
适合阶段快速概念、局部建模、批处理方案研究、规则生成、变体探索
AI 难点几何 API、曲面 / 布尔稳定性组件搜索、连线正确性、数据树
失败模式几何失败、对象错位、布尔失败连线错、数据结构错、求解报错
推荐策略RhinoMCP 工具 + Python 脚本MCP 建图 + GH Python 混合
Best Practice混合,而非二选一
Logic
Grasshopper

管「生成逻辑」——规则、约束、参数关系。

Geometry
Rhino

管「最终几何」——图层、人工编辑、出图准备。

Automation
Codex

管「脚本、组件图、参数接口、错误修复、批量任务」。

Judgment
建筑师

管「目标、审美、空间逻辑、约束与验收」。

SEC.04Ecosystem

五个项目,五种位置Ecosystem Maturity Review

04
4.1

Rhino MCP Platform

官方 / 半官方 · 面向 MCP 客户端的连接平台
文档直接覆盖 Codex、Claude、Gemini CLI、本地 LLM;安装路径清晰(PackageManager + MCPConnect),支持 Rhino 8 / 9 WIP。当前最值得优先验证。风险:生态仍新,GH2 工具需 Rhino 9 WIP。
中高 · 第一优先
4.2

RhinoMCP

Jingcheng Chen · 开源 MIT · Rhino + GH 双线
工具覆盖最广:几何、布尔、loft、图层、截图、执行脚本;GH 侧支持建图与求解。架构清晰、适合二次开发。风险:本地 TCP 无认证、允许执行脚本,安全边界需自管;第三方项目非官方。
中高 · 研究原型
4.3

grasshopper-mcp

GH ↔ Claude Desktop 桥 · 组件知识库
专注 GH,「组件知识库」思路可降低 LLM 摆组件失败率;Rhino 7+ / Python 3.8+ 可试。风险:文档面向 Claude Desktop 而非 Codex,项目规模小、社区有限,.gha 安装需手工排查。
中 · 专项参考
4.4

Ant — AI for Grasshopper

GH 内置 AI 副驾驶 · Ask / Build 双模式
建筑师友好:GH 内直接聊天、选中组件作上下文、解释调试与生成修改,兼容 Rhino 7/8。风险:开源性、模型后端、数据安全待确认;企业管线可控性不如自建 MCP。
中高 · 日常辅助 / 对照组
4.5

Rhino.Compute / Hops

官方可扩展计算架构 · 非 AI 插件
官方、稳定、工程化:外部调用 RhinoCommon、运行 GH 定义、Python/JS/.NET 客户端、并行异步。适合作为第二阶段工程化底座,把建筑生成器变成 API。风险:部署复杂、授权计费、不解决自然语言理解。
高 · 工程化底座
SEC.05Roadmap

四个阶段推进Four-Phase Roadmap

05
PHASE 01

本地最小可行验证

目标:证明 Codex 能稳定驱动 Rhino/GH。验收:能创建几何、能读取文档或截图、出错能迭代修正、GH 定义可人工继续调参。

6×6 塔楼体块阵列 · 高度渐变上色 曲线 loft 屋顶 / 廊架 GH 点吸引柱阵 GH 立面:slider 控开窗率 边界生成密度渐变铺装
PHASE 02

建筑专用工具层

不让 Codex 每次直调底层 API,而是封装建筑语义工具——显著降低失败率,建立建筑师可控的 AI 建模规范。

create_floor_plate() generate_facade_grid() create_tower_massing() generate_landscape_paths() evaluate_basic_metrics()
PHASE 03

GH-first 参数化工作流

重点不是「一次性生成最终模型」,而是生成可继续设计的参数化系统

自然语言任务Codex 解析意图参数清单GH 组件图 / 脚本Rhino 实时预览建筑师反馈Codex 修改迭代导出 3DM / 数据表
PHASE 04

接入分析与评价

真正价值来自「生成 + 评价」闭环,并与 Ladybug/Honeybee、Wallacei、OpenStudio、GIS 数据结合。

日照 / 阴影视线容积率 · 密度 · 绿地率路网连通性景观可达性立面开窗率构件数量与材料估算
SEC.06Risks

六条红线Risk Register

06
RISK—01
安全风险

RhinoMCP 类工具允许 AI 执行 RhinoScript/C#,只在本机 loopback 使用,不暴露公网。

RISK—02
误操作风险

AI 可能删除、覆盖、移动对象;强制保存副本、启用 undo、分层隔离。

RISK—03
几何可靠性

复杂 NURBS 与布尔最易失败,必须小步验证。

RISK—04
专业判断

AI 生成的模型不等于符合规范、结构、消防、施工与造价要求。

RISK—05
上下文风险

大文件不能无脑塞给模型;用摘要、选择集、图层过滤、局部编辑。

RISK—06
版权 / 数据

使用云模型时,项目模型、客户资料、图纸数据需注意保密策略。

SEC.07References

关键参考索引Key References

07
  • OpenAI Codex GitHubREF.01
  • OpenAI Codex – Rhino MCP PlatformREF.02
  • Rhino MCP Platform Getting StartedREF.03
  • RhinoMCP GitHubREF.04
  • grasshopper-mcp GitHubREF.05
  • Ant — AI for GrasshopperREF.06
  • Rhino.Python 官方文档REF.07
  • Grasshopper Python ScriptingREF.08
  • Rhino.Compute FAQREF.09
  • Rhino.Compute FeaturesREF.10
  • Hops ComponentREF.11
  • rhino3dm 官方说明REF.12
  • Rhino 8 System RequirementsREF.13
  • Rhino 8 EULAREF.14
  • Text2CAD-Bench, 2026REF.15
  • ToolCAD, 2026REF.16
  • LLMs for CAD SurveyREF.17
  • Sketch2CADScriptREF.18
Epilogue结语
不是生成模型,
而是生成设计系统
Not Models — Design Systems

GH 管生成逻辑,Rhino 管最终几何,Codex 管自动化,建筑师管目标与验收。受控、可迭代、可接管——这才是 AI 进入建筑建模的正确姿势。