Openscad MCP Server

🚀 OpenSCAD 3D Modeling Server

An open - source platform that supports generating high - quality 3D models from text. It integrates multiple functional modules, including image generation, multi - view processing, 3D reconstruction, and remote computing capabilities.

🚀 Quick Start

The OpenSCAD 3D Modeling Server is an open - source platform enabling the generation of high - quality 3D models from text. It integrates various functional modules, offering a comprehensive solution for 3D modeling tasks.

✨ Features

• AI - Driven Image Generation: Supports two image generation services, Google Gemini and Venice.ai.
• Multi - View Workflow: Implements a complete process from image generation to 3D model construction.
• OpenSCAD Integration: Provides parametric modeling capabilities and design optimization functions.
• Remote Computing Support: Can be extended to high - performance servers for 3D reconstruction.
• Network Printer Compatibility: Supports direct connection and control of 3D printers.

📚 Documentation

1. Image Generator

• Google Gemini API: By default, uses the Gemini 2.0 Flash Experimental model.
• Venice.ai API: Supports multiple image generation models (additional keys required).
• User - Customized Images: Allows uploading existing pictures for modeling.

2. Multi - View Processing Workflow

1. Image Generation: Generates multi - angle views based on the input text.
2. Image Review: Provides an online interface for viewing and confirming images.
3. 3D Reconstruction: Builds models from approved images using CUDA MVS technology.
4. Model Optimization: Supports parametric adjustment with OpenSCAD.

3. Remote Computing Workflow

1. Server Discovery: Automatically identifies computing nodes in the network.
2. Task Distribution: Sends processing requests to idle servers.
3. Status Monitoring: Provides real - time progress and resource usage information.
4. Result Download: Supports remote retrieval of model files.

4. Model Export Formats

• OBJ: Wavefront standard format.
• STL: Standard Triangle Language.
• PLY: Polygon File Format.
• SCAD: OpenSCAD source code.
• CSG: Parametric modeling data.
• AMF: Additive Manufacturing Format.
• 3MF: 3D Manufacturing Format.

5. Network Interfaces

• UI Interface: Offers a graphical operation panel (Access address: http://localhost:8000/ui/).
• REST API: Supports programmatic operations.
• WebSocket: Real - time status updates and event listening.

📦 Installation

1. Environment Requirements

• Operating System: Linux (recommended) or Windows (UI only).
• Memory: At least 4GB RAM.
• Graphics Card: Supports CUDA acceleration (optional).

2. Installation Steps

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

3. Start the Service

python openscad_server.py --port=8000

💻 Usage Examples

Basic Usage

1. Generate Images

{
  "prompt": "A cute rabbit",
  "num_views": 4,
  "model": "gemini-2.0-flash-exp-image-generation"
}

2. Create a 3D Model

{
  "image_ids": ["view1", "view2", "view3", "view4"],
  "output_name": "Rabbit Model"
}

3. Export Model Files

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

🔧 Technical Details

1. Image Generation Module

• Based on diffusion models for image synthesis.
• Supports various image quality and style options.
• Provides real - time preview functionality.

2. 3D Reconstruction Algorithm

• Uses CUDA - accelerated MVS technology.
• High - precision point cloud processing.
• Automatic meshing output.

3. Network Architecture

• Based on a microservices design.
• Supports horizontal scaling.
• Provides load - balancing capabilities.

🤝 Development and Contribution

All developers are welcome to contribute to the project! Please refer to the Contributing Guide for details on how to contribute code.

📄 License

This project is licensed under the MIT License. Please see the LICENSE file for more information.