Mcp Openscad Render Loop

Archimedes Marketで検証済みのアセットです。4つの観点（セキュリティ・品質・ライセンス・複雑さ）からなるTrust Reportの全文と、厳選されたカタログはアセットページでご覧いただけます。

---

MCP OpenSCAD Render Loop

OpenSCADをMCP サーバーとしてラップし、エージェントがGUIを行き来することなく、パラメトリックCAD設計を反復できるようにします。パラメーターを上書きして.scadソースをレンダリングし、パラメータースイープを実行し、構文を検証し、モジュールシグネチャを抽出し、STLの形状メトリクスを計算できます。

ツール

• render_stl — -Dパラメーター上書きを使い、.scadファイルまたはインラインソースをSTLにレンダリングします
• render_png — カメラと画像サイズを制御してプレビューをPNGにレンダリングします
• parametric_sweep — 1つ以上のパラメーター範囲を直積スイープし、出力のマニフェストを返します
• validate_scad — openscad --checkで構文をチェックします（レンダリングなし）
• list_modules — トップレベルのmodule foo(...)とfunction bar(...)のシグネチャをデフォルト値とともに抽出します
• compute_metrics — STLから境界ボックス、体積、表面積、三角形数を計算します

このサーバーが作られた理由

OpenSCADのCLIはよく設計されていますが、冗長です。エージェントによるCADワークフローの大半は、同じループを繰り返します。パラメーターを編集 → レンダリング → 測定 → 調整。このサーバーを使えば、反復ごとに1回のツール呼び出しにまとめられ、形状メトリクスが直接返されるため、エージェントが自分でSTLのバイト列を解析する必要がありません。

クイックスタート

# 1. Install OpenSCAD (must be on PATH)
brew install openscad      # macOS
apt-get install openscad   # Debian/Ubuntu

# 2. Install the MCP server
pip install mcp-openscad-render-loop

# 3. Set output directory and run
export MCP_OPENSCAD_OUTPUT_DIR="/tmp/scad-renders"
mcp-openscad-render-loop serve

Claude Desktopの設定：

{
  "mcpServers": {
    "openscad": {
      "command": "mcp-openscad-render-loop",
      "args": ["serve"],
      "env": {
        "MCP_OPENSCAD_OUTPUT_DIR": "/tmp/scad-renders",
        "MCP_OPENSCAD_BINARY": "/usr/local/bin/openscad"
      }
    }
  }
}

一般的なエージェントのワークフロー

Agent: "Design an enclosure for a 60x40x15mm PCB with 2mm walls and M3 mounting posts."
↓
1. list_modules on enclosure.scad → finds module enclosure(pcb_l, pcb_w, pcb_h, wall, post_dia)
2. render_stl with pcb_l=60, pcb_w=40, pcb_h=15, wall=2, post_dia=3 → enclosure_v1.stl
3. compute_metrics on enclosure_v1.stl → bbox 66x46x21, volume 18.4cm³, 1,240 triangles
4. parametric_sweep on wall ∈ [1.5, 2.0, 2.5] → 3 STLs + metrics → wall=2 is the strength/weight knee
5. render_png at iso camera → preview image attached to agent's reply

安全性

• 書き込み可能なパスはMCP_OPENSCAD_OUTPUT_DIRのみです。このディレクトリ外の出力パスはすべて拒否されます。
• 各レンダリングには60秒のハード上限が設定されています（変更可能）。長時間のスイープではレンダリングを並列ではなく順次実行し、メモリ使用量を抑えます。
• インラインの.scadソースは出力ディレクトリ内の一時ファイルに書き込まれます。openscad以外で実行されるものはありません。
• import("/some/path.dxf")によるパストラバーサルはできません。.scad内の相対パスは出力ディレクトリまたはソースファイルのディレクトリを基準に解決され、/を基準に解決されることはありません。

ライセンス

MIT。