OpenSCAD

OpenSCAD MCP Server

OpenSCAD（SCAD）のソースコードからPNG プレビューとSTL ジオメトリをレンダリングする MCP（Model Context Protocol）サーバーです。モデルを視覚的にプレビューし、後続の用途（製造、シミュレーション、検査など）向けにエクスポートできる、エージェント主導の反復的な 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）

スキル

このリポジトリには、反復的な SCAD → PNG → 評価 → 改良のループを支援するために、この MCP サーバーの使い方を紹介するOpenSCAD 反復モデリングスキルも含まれています。

制限事項

• パフォーマンス：複雑な SCAD モデルのレンダリングには時間がかかる場合があり、特に WASM 環境では顕著です。
• 機能のサポート：OpenSCAD のすべての機能が完全にサポートされているとは限らず、WASM 版では制限がある場合があります。
• フォント：現在、テキストのレンダリングには対応していません。今後のリリースで対応を予定しています。

インストール

公開されているパッケージは、stdio 経由で実行することを想定しています。npx を使って MCP クライアントで設定してください。

{
  "mcpServers": {
    "openscad": {
      "command": "npx",
      "args": ["-y", "openscad-mcp-server"]
    }
  }
}

HTTP 経由で実行する場合（Docker での実行など）は、--http を渡してください。

MCP_PORT=3000 npx -y openscad-mcp-server --http

サーバーは GET /health と、ステートレスなストリーム可能 HTTP MCP エンドポイント POST /mcp を公開します。

スキルの使用

エージェントスキルは、エージェントに新しい機能や専門知識を付与するための、シンプルでオープンな形式です。

OpenSCAD 反復モデリングスキルを使う最も簡単な方法は、skills CLIを使ってインストールすることです。

npx skills add fboldo/openscad-mcp-server --skill openscad-iterative-modeling

ローカル開発

• 依存関係をインストール：bun install
• Stdio（クライアントでの実行方法と同じ）：bun index.ts --stdio
• HTTP（手動テストに便利）：bun index.ts（または --http）
  • ポート：MCP_PORT（デフォルトは 3000）
  • エンドポイント：GET /health、MCP は POST /mcp
• MCP Inspector：bun run dev

類似プロジェクト

• jhacksman/OpenSCAD-MCP-Server ユーザーのプロンプトから画像を生成し、その後に3D再構築や3Dプリンターの検索まで行う、別のアプローチを採用したプロジェクトです。非常に興味深いプロジェクトです。OpenSCADやMCP サーバーに関心がある方は、ぜひご覧ください。

• petrijr/openscad-mcp このプロジェクトと似ていますが、Pythonベースのサーバーを使用し、レンダリングにはOpenSCAD CLIを利用します。

関連リンク

• OpenSCAD
• OpenSCAD WASM
• Model Context Protocol (MCP)
• Bun

ライセンス

MIT — LICENSEをご覧ください。