Jhacksman OpenSCAD MCP Server

🚀 OpenSCAD 3D モデル生成サーバ

OpenSCAD 3D モデル生成サーバは、3D モデルの生成、処理、およびエクスポートをサポートするサーバです。画像生成 API を利用して多視点画像を生成し、CUDA MVS 技術を用いて 3D モデルを再構築します。

🚀 クイックスタート

このサーバを使用するには、まずインストールが必要です。以下の手順に従ってインストールしてください。

📦 インストール

インストール要件

• オペレーティングシステム: Linux または Windows をサポート（Ubuntu 20.04+ の使用を推奨）
• Python バージョン: Python 3.8+
• 依存ライブラリ: OpenCV、Flask、requests、jsonschema、numpy、open3d
• CUDA サポート: CUDA 11+、3D モデル再構築の高速化に使用

インストール手順

git clone https://github.com/your-repository.git
cd openscad-server
pip install -r requirements.txt

✨ 主な機能

• 画像生成: Gemini と Venice.ai API をサポートし、視点数とスタイルをカスタマイズできます。
• 多視点処理: Web インターフェイスを通じて多視点画像の承認と管理が可能です。
• 3D モデル再構築: CUDA MVS 技術を利用してモデルを再構築し、ローカルとリモートサーバでの計算をサポートします。
• 形式エクスポート: OBJ、STL、PLY、SCAD などの複数の 3D ファイル形式をサポートします。

💻 使用例

基本的な使用法

画像生成

{
    "prompt": "可愛いウサギ",
    "num_views": 4,
    "model": "gemini-2.0-flash-exp-image-generation"
}

多視点再構築

{
    "image_ids": ["view_1.jpg", "view_2.jpg", "view_3.jpg", "view_4.jpg"],
    "output_name": "ウサギモデル"
}

📚 ドキュメント

機能オプション

画像生成選択

1. Google Gemini API（デフォルト）：Gemini 2.0 Flash Experimental モデルを使用し、高品質な画像を提供します。

   • 多視点スタイルの一貫性を持った生成をサポートし、Google API Key の設定が必要です。

2. Venice.ai API（オプション）：flux-dev や fluently-xl などの複数のモデルをサポートします。

   • Venice.ai API Key の設定が必要です。

3. カスタム画像：ローカル画像をアップロードし、既存の写真やレンダリング画像に適しています。

多視点ワークフロー

1. 多視点画像を生成する
2. 承認された画像を選択する
3. 3D モデルに変換する（ローカルとリモートの CUDA MVS をサポート）
4. オプションで OpenSCAD を使用してモデルを最適化する

リモート処理フロー

1. ネットワーク内の CUDA MVS サーバを検出する
2. 承認された多視点画像をリモートサーバにアップロードする
3. ジョブを送信し、進捗を追跡する
4. 完成した 3D モデルをダウンロードする

サポートエクスポート形式

• OBJ: 波front オブジェクトファイル（標準 3D モデル）
• STL: 標準三角形言語（3D 印刷に適しています）
• PLY: ポリゴンファイル形式
• SCAD: OpenSCAD ソースコード
• CSG: OpenSCAD CSG 形式（すべてのパラメータ属性を保持）
• AMF: 積層造形ファイル形式
• 3MF: 3D 製造形式（現代の STL 代替品）

Web インターフェイス

アクセスアドレス：http://localhost:8000/ui/

機能には以下が含まれます：

• 多視点画像の生成と承認
• 3D モデルのプレビュー（回転と拡大縮小をサポート）
• API キーとサーバ設定の管理
• 過去のジョブ記録の確認

📄 ライセンス

このプロジェクトは MIT ライセンスに従い、コードリポジトリのアドレスは OpenSCAD サーバー です。

🔧 貢献ガイド

PR または ISSUE の提出を歓迎します：

• 問題を提出する際には、ログファイルと詳細な説明を含めてください。
• PR を提出する前に、ユニットテストを通過させてください。
• リポジトリを Fork し、main ブランチに基づいて開発してください。