OpenSCAD MCP服务器
MCP（模型上下文协议）服务器，用于呈现 PNG预览 和 STL几何 来自OpenSCAD（SCAD）源代码。它旨在支持 迭代式、代理驱动的CAD工作流程，可以直观地预览模型并导出以供下游使用（例如制造、模拟或检查）。
⚠️ 贝塔\ 此MCP服务器目前处于测试阶段。性能、API和功能可能会发生变化。欢迎提出问题和意见。
用例
- 迭代代理驱动建模\
代理生成或修改OpenSCAD源代码，渲染PNG预览以评估形状和比例，并在多个回合中优化模型。
- MCP上下文中的几何伪影生成\
代理将STL文件导出为具体的几何工件，这些工件可以传递给下游工具、存储、检查或移交给其他启用MCP的系统。
- 参数化设计的视觉基础\
PNG预览为参数化或程序化SCAD代码提供了视觉基础，减少了幻觉，使代理能够推理空间变化。
- 设计验证和比较\
代理可以渲染模型的多个变体（例如参数扫描），并在决定保留或导出哪个几何体之前直观地比较结果。
可用工具
render_scad_png：从SCAD源渲染PNG预览图像。
- 输入： scadCode （字符串），可选 width/height （数字），可选 cameraPreset 可选 cameraPosition - cameraPreset：其中之一 isometric, front, back, left, right, top, bottom - cameraPosition: { x, y, z } - 输出：MCP ImageContent
export_scad_stl：导出从SCAD源生成的STL。
- 输入： scadCode （字符串），可选 filename （字符串） - 输出：MCP嵌入式资源（STL）
技能
此存储库还包括 OpenSCAD迭代建模技能 演示了如何使用此MCP服务器来支持迭代SCAD→ PNG → 批评→ 优化循环。
局限性
- 演出：渲染复杂的SCAD模型可能很慢，特别是在WASM环境中。
- 功能支持：WASM版本可能不完全支持所有OpenSCAD功能，也可能存在限制。
- 字体：当前不支持文本呈现。计划在未来的版本中提供支持。
安装
已发布的包旨在在stdio上运行。使用以下命令在MCP客户端中配置它 npx:
{
"mcpServers": {
"openscad": {
"command": "npx",
"args": ["-y", "openscad-mcp-server"]
}
}
}使用技能
代理技能 是一种简单、开放的格式，用于为代理提供新的功能和专业知识。
使用OpenSCAD迭代建模技能最简单的方法是使用 技能CLI:
npx skills add fboldo/openscad-mcp-server --skill openscad-iterative-modeling本地开发
- 安装deps：
bun install - Stdio（匹配客户端运行它的方式）：
bun index.ts --stdio - HTTP（适用于手动测试）：
bun index.ts
- 端口： MCP_PORT （默认值 3000) - 终点： GET /healthMCP在 POST /mcp
- MCP检查员：
bun run dev
类似项目
该项目提供了一种不同的方法，依赖于根据用户提示生成图像，然后进行3D重建，甚至发现3D打印机。这是一个非常有趣的项目，如果你对OpenSCAD和MCP服务器感兴趣，我建议你去看看。
与此项目类似，但它使用基于Python的服务器，并依赖OpenSCAD CLI进行渲染。
相关链接
许可证
麻省理工学院——见 许可证.
