Openscad AI Cs

OpenSCAD AI C#MCP服务器

C#中的HTTP MCP服务器，将OpenSCAD模型渲染为确定性多视图PNG图像，供LLM工具使用。

特性

• 基于HTTP的MCP(POST /mcp)使用JSON-RPC 2.0方法： initialize, ping, tools/list, tools/call
• 健康/根端点(GET /)返回 server up
• 工具： render_openscad

- 输入： scad_file_path （路径到 .scad 文件） - 可选输入： print_process (fdm 或 sla，默认值 fdm) - 固定渲染大小： 1600x1200 （不可由用户配置） - 输出：带有MCP的6个确定性视图 image 内容块（base64 PNG） - 视图：top_ne、缩放的top_ne x3、top_sw、bottom_ne、bottom_sw、top - 严格的印刷适性规则，自动执行：禁止边缘壁厚接近零；FDM的最小壁厚为1.0mm，SLA为2.0mm

• 工具： compare_renders

- 输入： reference_image_path （目标/原始图像）， rendered_image_path （OpenSCAD渲染） - 输出：具有解释的定量相似性度量 - 度量：SSIM（结构相似性）、MSE（均方误差）、直方图相关性、边缘对齐 - 自动调整图像大小以匹配尺寸，从而进行准确比较

• F6风格渲染管道（网格导出+渲染），不是OpenSCAD预览模式
• 相机居中于bbox模型中心($vpt)具有确定性距离($vpd)
• 在图像叠加上：顶部标签+XYZ图例（X红色，Y绿色，Z蓝色）
• 可选的CGAL验证工人集成，用于断开连接的零件和自交叉点

需求

• .NET SDK 10+
• OpenSCAD CLI可在 PATH 作为 openscad

跑

dotnet run --urls http://127.0.0.1:8770

要与CGAL worker一起运行：

CGAL_WORKER_PATH=/absolute/path/to/cgal_worker dotnet run --urls http://127.0.0.1:8770

默认工作路径（如果未设置env var）：

• Validation/cgal_worker/bin/cgal_worker

然后：

• GET http://127.0.0.1:8770/ -> server up
• POST http://127.0.0.1:8770/mcp 用于MCP JSON-RPC调用

MCP工具示例

渲染OpenSCAD模型

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "render_openscad",
    "arguments": {
      "scad_file_path": "/absolute/path/to/model.scad"
    }
  }
}

将渲染图像与参考进行比较

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "compare_renders",
    "arguments": {
      "reference_image_path": "/path/to/original_photo.png",
      "rendered_image_path": "/path/to/render_top_ne.png"
    }
  }
}

退货：

• ssim：0.0-1.0（1.0=结构相同）
• mse：越低越好（\500显著差异）
• histogram_correlation：-1.0到1.0（>0.90的颜色匹配良好）
• edge_alignment：0.0-1.0（>0.80边缘对齐良好）