SolidCraft 上手指南：开源参数化 3D 建模，免费桌面、网页与 MCP AI 建模

SolidCraft 上手指南：开源参数化 3D 建模，免费桌面、网页与 MCP AI 建模

【免费下载链接】solidcraftSolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.项目地址: https://gitcode.com/gh_mirrors/so/solidcraft

SolidCraft 是一款用纯 Rust 编写的开源参数化 3D CAD 软件，核心工作流是"草图—约束—实体特征—参数联动"，桌面版、浏览器版、命令行 CLI 和内置 MCP 服务器跑的是同一套引擎。适合 3D 打印爱好者、创客、学生，以及不想再为商业 CAD 交年费的工程师。

为什么值得看

SolidWorks、Fusion 360 这类商业 CAD 普遍按年订阅，且模型与单一生态绑定；手工建模时尺寸又是"死数字"，改一个值要逐个特征手动修补。SolidCraft 的差异在于参数化特征时间轴：每个操作都记录为可编辑的步骤，模型由时间轴计算而来。修改一个上游尺寸后，下游的倒角、孔位、抽壳会自动重算，不需要重新画。

可验证性方面，项目公开了一组参考测试：76 个公开参考零件中 75 个的体积、表面积、质心与解析计算或 FreeCAD 独立计算结果一致，另一个是登记在案的已知问题（见参考测试文档）。对早期开源项目来说，这是可以据此判断成熟度的实据。

最短上手路径

不建议把源码编译当主线：Rust 编译慢，这个项目体量大，首次构建要拉取大量依赖，新手容易卡在依赖报错上。三条现成路线：

• 桌面安装包：Windows、macOS（Apple Silicon 与 Intel）、Linux AppImage / Snap / deb / rpm，详见下载说明；
• 网页版：浏览器直接建模，无需安装，适合先体验再决定；
• 确要编译：git clone https://gitcode.com/gh_mirrors/so/solidcraft后执行cargo run --release -p solidcraft即可带示例零件启动桌面版，细节在构建文档。

⚠️ 注意：Windows 安装包目前未做代码签名，SmartScreen 提示时选择"更多信息 → 仍要运行"；macOS 版本已完成 Apple Developer ID 公证，可正常打开。

参数化建模工作流拆解

一个可复用的模型分四层，链路上每一层都可回溯修改：

1. 草图：线段、圆弧、样条、文字，尺寸直接标注在几何上；
2. 约束：平行、垂直、相切、网格吸附，几何由参数驱动，画完不会"漂移"；
3. 特征：拉伸、旋转、扫描、放样、倒圆、倒角、抽壳、孔、螺纹、阵列、镜像、分割、布尔合并，全部落在时间轴上；
4. 参数联动：参数与配置支持带单位的表达式。官方演示从空白设计画出一个外壳，把高度从 24 改为 32 mm，整个模型自动重建。

下图是软件自带的示例零件界面，左侧浏览器树、底部 History 时间轴把整条参数化链路都摊在明面上：

导出覆盖主流格式：STEP、IGES、3MF、STL、OBJ、glTF 与 URDF；设计本身存为.sc文件，早期版本的.solidcraft文件仍可打开。完整能力清单见capabilities与features。

自动化与 AI 接入（MCP）

solidcraft-cli mcp是一个标准 Model Context Protocol 服务器。AI 代理执行的是与 UI 相同的引擎命令，而不是模拟点击界面，因此结果稳定、可回放：

• 无头模式独立跑一个设计会话；加--connect则接入正在运行的桌面版，边建模边观看；
• 给 Claude Code 注册只需一行：claude mcp add solidcraft -- solidcraft-cli mcp；
• 社区案例：有用户完全通过 MCP 指令建出一台科学探测车，3323 个时间轴步骤可回放重建（见showcase）。

MCP 之外，脚本是更轻的自动化入口：把 UI 命令序列写成 JSON，用solidcraft-cli run examples/bracket.json --out bracket.step直接产出 STEP 文件，格式见脚本文档。

排障可压缩成一句话：先确认程序在运行，再查本机控制端口与令牌（每次启动生成），再查目录权限，最后才怀疑命令参数。AI 代理默认只能读写设计文件所在目录和显式放行的目录（--allow-path），遇到"无权限"提示属于这个安全边界在工作，完整规则见MCP 文档。

适用人群与选型建议

• 3D 打印 / 创客：STL、3MF 导出可对接切片与打印流程；
• 学生 / 成本敏感工程师：MIT OR Apache-2.0 双许可，无年费；支持 SpaceMouse 等专业 3D 鼠标（见3D 鼠标文档）；
• 钣金与装配需求：提供钣金折边、翻边、展开图，装配体支持关节、运动研究、干涉与质量属性检查。

选型上建议：网页版先试手感 → 桌面版做正式建模 → CLI + MCP 做批量与自动化。注意项目自我定位是"early but usable for simple parts"（早期但可处理简单零件），复杂零件的通过率和特性完整度仍在随版本推进，规划见ROADMAP。

行动清单

1. 下载对应平台的安装包或打开网页版，用示例零件走完"草图—尺寸—拉伸—倒角—导出 STEP"这条链；
2. 做一次参数联动验证：改动时间轴上的一个尺寸，确认模型整体重建，这是参数化建模的核心收益；
3. 想做 AI 或脚本自动化，先读 docs/mcp.md，再运行solidcraft-cli mcp验证本机连接。

【免费下载链接】solidcraftSolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.项目地址: https://gitcode.com/gh_mirrors/so/solidcraft