Openscad MCP Server

🚀 OpenSCAD 3Dモデリングサーバ

OpenSCAD 3Dモデリングサーバは、テキストから高品質な3Dモデルを生成することをサポートするオープンソースプラットフォームです。このシステムは、画像生成、マルチビュー処理、3D再構築、リモート計算機能など、様々な機能モジュールを統合しています。

✨ 主な機能

• AI駆動の画像生成：Google GeminiとVenice.aiの2種類の画像生成サービスをサポート
• マルチビューワークフロー：画像生成から3Dモデル構築までの一連の流れを実現
• OpenSCAD統合：パラメトリックモデリング機能と設計最適化機能を提供
• リモート計算サポート：高性能サーバへ拡張して3D再構築を行うことが可能
• ネットワークプリンタ互換性：3Dプリンタへの直接接続と制御をサポート

📦 インストール

1. 環境要件:

   • オペレーティングシステム: Linux (推奨) または Windows（UIのみ）
   • メモリ: 少なくとも4GB RAM
   • グラフィックカード: CUDAアクセラレーションをサポート（オプション）

2. インストール手順:

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

3. サービスの起動:

   python openscad_server.py --port=8000
   

💻 使用例

基本的な使用法

1. 画像生成

{
  "prompt": "一只可爱的兔子",
  "num_views": 4,
  "model": "gemini-2.0-flash-exp-image-generation"
}

2. 3Dモデルの作成

{
  "image_ids": ["view1", "view2", "view3", "view4"],
  "output_name": "兔子模型"
}

3. モデルファイルのエクスポート

{
  "model_id": "rabbit_model",
  "format": "STL"
}

📚 ドキュメント

機能モジュール

1. 画像生成器

• Google Gemini API: デフォルトでGemini 2.0 Flash Experimentalモデルを使用
• Venice.ai API: 複数の画像生成モデルをサポート（追加のキーが必要）
• ユーザー定義画像: 既存の画像をアップロードしてモデリングすることができます。

2. マルチビュー処理フロー

1. 画像生成: 入力テキストに基づいて多角度のビューを生成
2. 画像審査: 画像を確認するためのオンラインインターフェースを提供
3. 3D再構築: 承認された画像からCUDA MVS技術を使用してモデルを構築
4. モデル最適化: OpenSCADを使用したパラメトリック調整をサポート

3. リモート計算ワークフロー

1. サーバー検出: ネットワーク内の計算ノードを自動的に識別
2. タスク配信: 処理要求を空きサーバーに送信
3. 状態監視: リアルタイムの進捗状況とリソース使用状況を提供
4. 結果のダウンロード: モデルファイルのリモート取得をサポート

4. モデルエクスポート形式

• OBJ: 波front標準形式
• STL: 標準三角形言語
• PLY: ポリゴンファイル形式
• SCAD: OpenSCADソースコード
• CSG: パラメトリックモデリングデータ
• AMF: 加工製造規範形式
• 3MF: 現代製造標準

5. ネットワークインターフェース

• UIインターフェース: グラフィカルな操作パネルを提供（アクセスアドレス：http://localhost:8000/ui/）
• REST API: プログラムによる操作をサポート
• WebSocket: リアルタイムの状態更新とイベント監視をサポート

🔧 技術詳細

1. 画像生成モジュール

• 拡散モデルに基づく画像合成
• 複数の画質とスタイルオプションをサポート
• リアルタイムプレビュー機能を提供

2. 3D再構築アルゴリズム

• CUDAアクセラレーションされたMVS技術を使用
• 高精度の点群処理
• 自動メッシュ化出力

3. ネットワークアーキテクチャ

• マイクロサービス設計に基づく
• 水平拡張をサポート
• 負荷分散機能を提供

🤝 開発と貢献

すべての開発者の貢献を歓迎します！コードを貢献する方法については、Contributing Guideを参照してください。

📄 ライセンス

このプロジェクトはMIT Licenseに準拠しています。詳細はLICENSEファイルを参照してください。