b123d-print

b123d-print

为 3D 打印打造的 Vibe CAD。 用通俗的语言告诉 AI 助手你需要什么，再提供一张照片和几项卡尺测量数据。它会设计零件、从各个角度检查、排查打印问题，并为你的切片软件生成文件。无需 CAD 技能，且适用于任何支持 MCP 的助手：Claude、Gemini CLI、Cursor、VS Code Copilot、Codex，以及更多（了解哪些客户端，以及如何连接各客户端）。

可以制作什么

像向一位有卡尺和 CAD 程序的朋友提需求那样告诉它。以下设计都已完成并打印出来：

• “给这块红外发射板做个盒子：LED 朝上，盖子用螺丝固定，再加两个耳片，方便安装到墙上。” 一个两件式外壳，还用板子的替代模型检查过，确保尺寸合适。
• “给这个运动传感器做个户外外壳。它应该能从墙板上滑下来，还能挡住雨水。” 燕尾导轨、卡入式定位结构、排水槽，以及无需支撑即可打印的盖子。
• “做一块转接板：后面是双联盒，前面是单联智能开关。” 带沉孔的螺丝孔；第一版打印件穿透了 0.05 mm 的薄壁，而渲染图没有显示这个问题，因此后来加上了墙面检查。

或者 改造你下载的模型（STL、3MF 或 STEP）并进行修改：

• “这是我下载的一个 L 形支架 STL：把两个安装孔改成槽孔，再加上加强筋。” 系统将原模型作为实体导入并进行修改；检查结果会区分原模型的缺陷和新产生的问题，前后对比视图则会准确显示改动位置。（这是文档演示，尚未打印。）

长时间打印前，使用配合测试模板测试是否合适：从实际零件上截取一块薄片，快速打印出来。

• “为安装面制作一个配合测试模板，这样我就能检查孔位排列是否正确。” 助手会用红色标出这个面，让你确认，然后生成一块 1.2 mm 厚的板，孔位与零件完全一致：几分钟就能打印好，而不是等上几个小时。

要测量大型、弯曲或形状复杂的物体？为 AI 测量会介绍该用哪种工具、如何放置刻度拍照，还提供可直接复制粘贴的测量表，以及偏移量表格（沿基准线分布的测量位置），让你清晰无误地传递数据。

还有日常用品：垫片、旋钮、支架、线缆夹，以及可根据测量结果制作的损坏零件替代品。之后还可以继续对话：“再加高 5 mm”“加一个 M4 螺丝孔”“盖子太紧了”。每个尺寸都会作为命名数字保留在简短的 build123d 脚本中，因此每次修改都很精确；你还可以获得 STEP 文件，按需在其他 CAD 软件中继续编辑。

红外收发器板的两件式盒子，含板子替代模型	穿过 LED 的剖面：盖子锥面、板子和间隙
户外传感器外壳：燕尾背板 + 无需支撑的盖子	墙板：刚越过表面的剖面，即墙面检查的位置
改造：下载的支架，改造前后对比	改造差异：红色为切除部分，灰色为新增部分

文档：https://kd5ryn.github.io/b123d-print/

2 分钟快速上手

b123d-print 的 MCP 服务是一个插件，可为你的 AI 助手提供 CAD 工具。它在你的 电脑上运行。

**简便方式：**将以下内容粘贴到你的 AI 助手中（Claude Code、Claude Desktop、Cursor、 Gemini CLI、Codex，……）：

Install the b123d-print MCP server for me. It runs with
`uvx --from b123d-print b123d-print-mcp --workspace <folder>`
where <folder> is a folder for my parts, such as ~/parts.
Install uv first if it is missing (https://docs.astral.sh/uv/).
Add the server to your MCP settings, tell me when to restart you,
and after the restart check that its tools (list_parts, new_part,
build_part, ...) are available.

它可能会要求运行几条命令（安装 uv 并添加服务）：这是正常的。

手动设置：

1. 安装 uv，它会获取 Python 以及 b123d-print 所需的其他内容。

2. 添加服务。Claude Code：

   claude mcp add b123d-print -- uvx --from b123d-print b123d-print-mcp --workspace ~/parts
   

   或一步安装 Claude Code 插件（服务 + 技能）：

   /plugin install b123d-print --marketplace KD5RYN/b123d-print
   

   Claude Desktop（Settings → Developer → Edit Config）：

   {
     "mcpServers": {
       "b123d-print": {
         "command": "uvx",
         "args": ["--from", "b123d-print", "b123d-print-mcp", "--workspace", "/Users/you/parts"]
       }
     }
   }
   

   Cursor、VS Code、Gemini CLI、Codex 等： 连接你的 MCP 客户端。

3. 重启助手。

**告知它你的打印机：**询问 “为我的打印机设置 b123d-print”（setup_workspace 提示词；在终端中运行 b123d-print setup）：打印机、材料、导出格式、风格，然后是校准测试件。

然后询问： “设计一个直径 40 mm、高 10 mm、带 M3 孔的圆形垫片。” 文件会放在你零件文件夹下的 parts/<name>/out/ 中；供切片软件使用的文件位于 out/print/ （要保存哪些文件）。首次启动时会下载数百 MB 的内容，可能需要几分钟（故障排除）。 助手会查看渲染结果来检查工作，因此请使用会将工具图像传递给模型的客户端（Claude Desktop 和 Claude Code 都支持）。

**跟随完整流程：**从安装到打印，制作你的第一个零件：搁板支架，以及改造下载的 STL 文件。

**适用范围：仅限 FDM 3D 打印零件。**所有设计都围绕打印零件展开： 打印方向（打印床位于 Z=0）、孔补偿、配合间隙、校准测试件，以及基于来源明确的 FDM 设计规则制定的打印检查。 它不是通用 CAD 框架。

包含内容

• b123d-print 包 + CLI — 导出、六视图渲染、彩色多零件剖面，以及打印检查：配合零件之间的重叠、打印方向上的悬垂和桥接、切口周围的薄特征和壁厚、孔洞（顶部为圆形、容易下垂）、床边圆角、活动零件之间的间隙、探测项（“顶部是否封闭？”）。
• b123d-print-mcp — 一个 MCP 服务，因此可通过 Claude Desktop、Claude Code、Gemini CLI、Cursor、VS Code、Codex 和其他 MCP 客户端使用。零件脚本是模型编写的代码：它们在设有超时限制且无法访问网络的沙盒中运行。
• compare — 将零件与参考 STL、3MF 或 STEP 进行比较：尺寸、体积和表面差异、0–100 的评分、通过/失败结果，以及偏差视图（比较零件）。
• Remix — 从别人的 STL、3MF 或 STEP 开始：import_model 会将网格转换为实体（合并共面三角形），检查结果会区分原始模型的问题和 Remix 新增的问题，前后对比视图则会展示改动（混编零件）。
• Replicate — 复制实体零件，通常是模制零件：提供测量计划，标明每个尺寸是关键尺寸还是自由尺寸，说明为适配 FDM 而修改的模制特征及其原因，并通过 replication_spec 根据 MEASURE.md 中的读数检查模型（复制实体零件）。
• 适配测试模板 — 打印真实零件一个面、一个切片或一个区域的轻薄测试件（保留相同的孔和间隙），在完整打印前检查孔位和配合情况（适配测试模板）。
• 设计评审 — 打印检查通过后，助手会按照你选择的风格评审零件（功能型、现代型、最低成本、坚固/户外型、柔和/手持型、结构型/承重型、有机/自然型、装饰/花瓶型、玩具/儿童安全型）： 粗略估算耗材和打印时间、检查支撑、边缘处理、层级台阶、积水点、内角和壁厚、玩具的小零件，并根据有来源的设计规则提供具体建议。未经你同意，不会做任何更改（设计评审）。
• 模型无关的工作流 — MCP 提示词，以及任何 Agent 都能读取的 AGENTS.md。这些规则源自实际打印经验；其中一条规则正是因为某个零件穿过了渲染中看不出来的 0.05 mm 薄层而断裂。
• 示例 — 四个以此方式设计并打印的零件，以及用于校准孔洞、配合、悬垂和桥接的校准试片，位于 src/b123d_print/examples/。

进阶：在另一台机器上运行

大多数人不需要此功能。若要将零件保存在家用服务器上，并通过笔记本电脑进行设计，请使用 SSH；若要让多个 Agent 共用一台服务器（运行评测、团队协作）， 请使用带有每个工具专属命名令牌的 HTTP；若要实现最强隔离 （也支持 Windows），请使用 Docker。 哪种模式？ 对这些模式进行了比较。

文档

从这里开始	教程：制作第一个零件 · 教程：修改下载的 STL
入门	快速开始 · MCP 客户端（Claude Desktop、Claude Code、claude.ai、ChatGPT、Gemini CLI、Antigravity、OpenCode、Qwen Code、pi、Cursor、VS Code、Codex、Grok、Windsurf、Zed、LM Studio） · CLI 和 Python
进阶	选哪种模式？ · 通过 SSH 远程使用 · 通过网络（HTTP）使用 · Docker
使用指南	会话流程 · 为 AI 测量 · MCP 工具和提示词 · 输出格式 · 从零件到打印 · 设置 · 孔位补偿 · 打印机配置文件 · 检查项 · 沙盒 · 比较零件 · 修改零件 · 复刻实物零件 · 配合测试模板
零件脚本	零件脚本 · 检查 API · 示例 · 工作流规则 · 设计规则（来源）
更多	常见问题 · 参考资料 · 更新 · 故障排除 · 参与贡献 · Agent 评估 · 致谢和许可证

状态

0.x — 早期阶段。 零件脚本约定仍可能发生变化。每次推送时，CI 都会测试 macOS、Ubuntu 和 Windows、通过 uvx 构建的软件包，以及 Docker 镜像。在 Windows 上，服务会以原生方式运行以供本地使用，但没有操作系统沙盒（仅有进程隔离和审计钩子）；如需隔离，请使用 WSL2 或 Docker。SSH 模式的服务端仅支持 macOS 和 Linux；Windows 可作为 SSH 或 HTTP 客户端。平台和状态。

致谢和许可证

b123d-print 是基于 build123d、 Open CASCADE Technology（通过 OCP）、 lib3mf、OrcaSlicer 的 打印机数据、用于零件脚本的 bd_warehouse 和 py_gearworks、 matplotlib、NumPy、 MCP Python SDK 和 uv 构建的轻量层。 详情和再分发说明：THIRD_PARTY.md。

MIT © KD5RYN 和贡献者。