借助 Codex 搓了个 SketchUp MCP：想帮做设计的朋友提点效，诚邀专业大佬一起维护
作者 ：梁工
项目源码：https://github.com/PL-FE/sketchup-ai-toolkit （代码已开源，水平有限，欢迎大佬们随时挑刺、提 PR 一起完善）
缘起：看朋友加班太苦，萌生了个念头
前段时间和一个做景观设计的朋友聚会，看他整个人特别疲惫。一问才知道，最近方案赶得紧，他每天大部分时间都耗在 SketchUp（SU）里机械重复地推拉模型、切槽分缝、改尺寸。
我当时就想：现在大模型写代码、调 API 这么方便，能不能帮他搞个工具，他在聊天界面里说句话，SU 就能自动把这些基础模型建出来，哪怕帮他省点重复体力活也好？
说实话，我本身完全不是建筑或者景观专业的，平时也不怎么用 SU，对里面的专业工法和底层逻辑可以说一窍不通。
整个项目的真实研发过程，其实非常质朴：
- 在自己电脑上装好对应版本的 SketchUp；
- 翻出 SketchUp 官方的 Ruby 开发文档；
- 全程直接借助 Codex 等 AI 编程工具，让它帮我研读官方文档、解析 API，带着我一步一步去写桥接代码与 MCP 服务；
- 就这样边问 Codex 边踩坑测试，才勉强把这个基于 Anthropic MCP (Model Context Protocol) 的小工具给跑通了（取名叫 SketchUp AI Toolkit）。
目前跑出来的效果（以"碚暖新驿站"为例）
在 Codex 的帮助下，我们把指令转译成 SU 的原生命令，目前让大模型直接控制本地打开的 SketchUp 2026，已经可以做出一些规整的基础构件了。
下面这张截图，就是通过在对话框给需求，让它直接在桌面端 SU 生成的便民服务驿站（碚暖新驿站）视口截图：
我拿给朋友看，至少在日常基础使用上已经有了一点实用价值：
- 生成的是原生组件（Component）：不是网上那些不可编辑的一整块神经网格，设计师想改哪个门窗，在 SU 里直接双击进去就能推拉；
- 基础构件分块清晰：拉出了外墙预制板的拼装分缝，门头做了造型挑檐，双开玻璃门也带上了金属拉手；
- 连防撞警示条也能带上：公建玻璃门上那条红色的"小心玻璃"安全贴条，在提示词里约定好后也能一起画出来。
整个工具是怎么连起来的？
逻辑其实并不复杂，主要是给大模型装上了一双可以操作本地 SU 的"手"：
[ AI 客户端 / Codex / Claude 等 ]
│ 标准 MCP 协议
▼
[ 本地 Node.js MCP 服务端 ] <-- 接收自然语言，通过提示词规范转为建模指令
│ 本地安全管道
▼
[ SketchUp 内置的 Ruby 插件 ] <-- 查阅官方文档写出来的桥接脚本
│ 调用官方 Ruby API
▼
[ 桌面端真实的 SketchUp 画布 ]在 Codex 帮我写代码的过程中，帮我解决掉了两个让我抓狂的问题：
- 几何非共面报错 ：一开始画弧形曲面时，SU 经常报
Points are not planar直接崩溃回滚。后来 Codex 查了官方逻辑，发现 SU 底层对四边形平面的公差卡在变态的 0.001 毫米，最终在 Codex 指导下改成了"空间三角剖分 + 平滑软化"，总算稳住了几何生成。 - 避免太像充气玩具：最开始建的坐凳圆滚滚的，被朋友笑话像吹气甜甜圈。后来朋友告诉我真实构件需要靠背倾斜、下部斜切和材料凹槽，我就把这些规矩补充到了提示词约束里，质感这才好转。
水平有限，真诚期待专业朋友一起维护！
说心里话，我毕竟是个非设计专业的"门外汉"，目前这个项目全凭 Codex 带着我摸索，充其量只算勉强把主流程打通了，存在很多明显的硬伤和不足：
- 建模提示词（Prompt/Skill）还很不专业：很多建筑、景观行业的标准构造做法、施工收口细节，我根本写不准确，极其需要真正懂行的一线设计师朋友帮忙指正和完善提示词库；
- 需要丰富更多 SU 版本：目前主要拿手头的环境做了适配，低版本或不同系统的兼容性还需要更多人一起测试完善；
- 复杂形体与高级材质：像不规则自然地形生成、PBR 贴图映射等高级功能，单靠我自己啃官方文档实在有点吃力。
项目的所有代码已经完整开源在 GitHub 上：
👉 仓库地址 ：https://github.com/PL-FE/sketchup-ai-toolkit
如果你平时也在用 SketchUp，或者对大模型落地建筑辅助设计感兴趣，特别欢迎来 GitHub 提 Issue、吐槽或者提交 PR！大家一起帮做设计的朋友们减减负、少加点无意义的班，感激不尽！