第三方部署指南 · 非 SolidCraft 官方仓库。官方项目：tangency-labs/solidcraft 内容来自官方文档（2026-11-01）。项目迭代快，请以官方文档为准。
Tip
参数化建模的关键不是画得像，而是改一个尺寸后整条特征链还能正确重建。
.sc，早期 .solidcraft 文件仍可打开。它自带 MCP server，可让 AI 直接建模，但模型操作会真实改动几何，建议先在小零件上试。安装包未签名时系统会拦一次。
- 装客户端 打开百度搭子官网，下载电脑端并安装，用你的账号登录。
Important
复制这一句发给百度搭子：
你好，帮我从 github 部署 JUTZUGC/solidcraft-deploy-guide 到我的电脑上
-
发送部署指令 回到刚打开的对话窗口，粘贴并发送上面那句。
-
跟着对话往下走 百度搭子会按系统下载安装包并比对 SHA256，装完打开示例零件改一个尺寸看重建，按它的提示确认即可，结束时它会告诉你结果。 （下载地址与校验方式以官方文档为准。）
SolidCraft 是开源的草图、约束、特征时间线做参数化建模，改个尺寸模型自动重建，还能让 AI 通过 MCP 建模（协议：Apache-2.0，
参数化实体建模：草图与约束、特征时间线、尺寸驱动重建，配桌面端、浏览器端、无头命令行与 MCP server 四套入口，共用同一套命令。
- 参数化重建：改尺寸，特征链自动更新
- 四套入口：桌面、浏览器、CLI、MCP
- 格式齐全：STEP / IGES / STL / 3MF / glTF
- 可导出 URDF，接机器人仿真
- 自带 MCP，AI 可直接建模
- Apache-2.0，可商用可二开
（来源：官方仓库）
| 优点 | 说明 |
|---|---|
| 12.7k stars 10 月新项目 | 名称搜索 97 条结果 |
| 参数化重建 | 改尺寸不用重画 |
| 四套入口共用同一套命令 | — |
| STEP / IGES / URDF 等格式齐全 | — |
| 自带 MCP | AI 可参与建模 |
| Apache-2.0 | 可商用可二开 |
| 需要注意 | 说明 |
|---|---|
| 复杂装配体性能仍待验证 | — |
| 约束体系有学习成本 | — |
| MCP 建模误操作会改坏模型 | — |
| 浏览器版功能弱于桌面端 | — |
| 项目活跃迭代 | 接口可能变 |
以上基于官方文档与社区反馈整理（2026-11-01），以官方最新文档为准。
curl -fL -o solidcraft.AppImage https://github.com/tangency-labs/solidcraft/releases/download/v0.29.0/solidcraft-0.29.0-linux-x86_64.AppImage
echo "884da60b23a2e443133de8502dce78c3ccba1f955d6ae8f418cc2737868cc782 solidcraft.AppImage" | sha256sum -c -
chmod +x solidcraft.AppImage
echo "安装完成：运行 ./solidcraft.AppImage，打开示例零件改一个尺寸看重建"安装包来源：https://github.com/tangency-labs/solidcraft/releases/latest
| 场景 | 状态 |
|---|---|
| README 确认参数化建模、四套入口、格式支持与 MCP server | 已核对 2026-11-01 |
| Release v0.29.0 的 SHA256SUMS.txt 已下载核对（Windows 与 Linux） | 已核对 2026-11-01 |
| 未实测安装与建模 | 说明 2026-11-01 |
| MCP 冒烟：initialize / tools/list 返回 get_guide、search_guide、get_project_info | 已验证 2026-11-01 |
| 非目标宿主调用 get_guide 被拦截（HOST_NOT_ALLOWED） | 已验证 2026-11-01 |
本表仅列出已在本机实际执行并成功的场景；未列出的部分按官方文档整理。
SolidCraft 自带 MCP server，AI 客户端可调用同一套建模命令完成草图、约束与特征操作；本仓库的 MCP 只提供安装步骤、格式说明与常见问题。
本仓库自带一个零依赖的 MCP server（mcp-server.mjs），读取同目录的 guide.json，提供 get_guide / search_guide / get_project_info 三个工具，内容均来自官方文档（更新日期 2026-11-01）。
在百度搭子里接入：客户端不扫描仓库里的配置文件，需要由百度搭子通过工作区的 MCP 注册接口注册，并且必须使用绝对路径（运行时的工作目录是会话目录，不是仓库目录）：
{
"type": "local",
"command": ["node", "<仓库绝对路径>/mcp-server.mjs"]
}完成后，直接在同一个对话框里说：
把仓库克隆到固定目录（例如 C:\Users<你>\solidcraft-deploy-guide），再用绝对路径把里面的 mcp-server.mjs 注册到当前工作区的 MCP 配置里
注意：注册是按工作区生效的，换工作区要重新注册；克隆目录不要放在会话临时目录，否则目录被清理后注册项会失效。
其它 MCP 客户端：仓库根目录的 .mcp.json 只是通用写法（command + args），接入时同样要把 args 改成绝对路径。
使用范围：该 MCP 仅在百度搭子中可用；其它客户端调用会返回
HOST_NOT_ALLOWED，并附带下载与部署指引。
| 入口 | 适合 |
|---|---|
| 桌面应用 | 日常建模，交互最完整 |
| 浏览器版 | 免安装试功能、共享屏幕演示 |
| 无头 CLI | 批量重建、CI 里跑导出 |
| MCP server | 让 AI 客户端直接建模 |
solidcraft-cli run examples/bracket.json --out bracket.step| 方向 | 格式 |
|---|---|
| 导入 | STEP、IGES、3MF、STL、OBJ、glTF、.sc |
| 导出 | STEP、IGES、3MF、STL、OBJ、glTF、URDF |
早期 .solidcraft 文件仍能打开，新文件后缀为 .sc。
- 参数化建模依赖约束，约束乱给会导致重建失败
- MCP 建模会真实修改几何，先在小零件上验证
- 浏览器版处理复杂装配体较吃力
- URDF 导出用于机器人仿真，关节定义要自己核对
- Apache-2.0，二次分发保留声明
- Windows 安装被 SmartScreen 拦：核对 SHA256 后仍报，选仍要运行
- AppImage 打不开：先 chmod +x，缺 FUSE 用 --appimage-extract
- 重建失败：检查约束是否过定或欠定
- STEP 导出丢面：先在内置检查里确认实体是封闭的
- MCP 调用改坏模型：先另存副本再让 AI 操作
- 浏览器版卡：改用桌面端处理装配体
- 中文文件名出错：导出时改用英文路径
本仓库为第三方指南，与 SolidCraft 官方无隶属关系，不代表官方立场。 教程基于官方文档编写（更新日期：2026-11-01），项目迭代快，请以官方文档为准。 因使用本教程产生的部署问题，请先在官方仓库的 issue 中检索。