Jhacksman OpenSCAD MCP Server

🚀 OpenSCAD 3D 模型生成服務器

本項目是一個 3D 模型生成服務器，支持多種圖像生成 API，可進行多視圖處理和 3D 模型重建，還能導出多種 3D 文件格式，為 3D 模型的創建提供了便捷的解決方案。

🚀 快速開始

本服務器可幫助你快速生成和處理 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 分支開發