Openscad MCP Server

🚀 OpenSCAD 3D建模服務器

OpenSCAD 3D建模服務器是一個開源平臺，支持從文本生成高質量3D模型。該系統集成了圖像生成、多視圖處理、3D重建以及遠程計算等多種功能模塊。

✨ 主要特性

• AI驅動圖像生成：支持Google Gemini和Venice.ai兩種圖像生成服務。
• 多視圖工作流：實現從圖像生成到3D模型構建的完整流程。
• OpenSCAD集成：提供參數化建模能力和設計優化功能。
• 遠程計算支持：可擴展至高性能服務器進行3D重建。
• 網絡打印機兼容性：支持直接連接和控制3D打印機。

📦 安裝指南

環境要求

• 操作系統：推薦使用Linux，Windows系統僅支持UI。
• 內存：至少4GB RAM。
• 顯卡：支持CUDA加速（可選）。

安裝步驟

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

啟動服務

python openscad_server.py --port=8000

💻 使用示例

常用命令示例

生成圖片

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

創建3D模型

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

導出模型文件

{
  "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. 網絡架構

• 基於微服務設計。
• 支持水平擴展。
• 提供負載均衡能力。

📄 許可證

本項目遵循MIT License協議，具體內容請參見LICENSE文件。

開發與貢獻

歡迎任何開發者參與項目開發！請參考Contributing Guide瞭解如何貢獻代碼。