OpenSCAD MCP Server

Features

• AI Image Generation: Generate images from text descriptions using Google Gemini or Venice.ai APIs

• Multi-View Image Generation: Create multiple views of the same 3D object for reconstruction

• Image Approval Workflow: Review and approve/deny generated images before reconstruction

• 3D Reconstruction: Convert approved multi-view images into 3D models using CUDA Multi-View Stereo

• Remote Processing: Process computationally intensive tasks on remote servers within your LAN

• OpenSCAD Integration: Generate parametric 3D models using OpenSCAD

• Parametric Export: Export models in formats that preserve parametric properties (CSG, AMF, 3MF, SCAD)

• 3D Printer Discovery: Optional network printer discovery and direct printing

Architecture

Installation

1. Clone the repository:

2. Create a virtual environment:

3. Install dependencies:

4. Install OpenSCAD:

5. Install CUDA Multi-View Stereo:

6. Set up API keys:

Remote Processing Setup

Server Setup (on the machine with CUDA GPU)

1. Install CUDA Multi-View Stereo on the server machine:

2. Start the remote CUDA MVS server:

3. The server will automatically advertise itself on the local network using Zeroconf.

Client Configuration

1. Configure remote processing in your .env file:

2. Alternatively, you can specify a server URL directly:

Remote Processing Features

• Automatic Server Discovery: Find CUDA MVS servers on your local network

• Job Management: Upload images, track job status, and download results

• Fault Tolerance: Automatic retries, circuit breaker pattern, and error tracking

• Authentication: Secure API key authentication for all remote operations

• Health Monitoring: Continuous server health checks and status reporting

Usage

1. Start the server:

2. The server will start on http://localhost:8000

3. Use the MCP tools to interact with the server:

Image Generation Options

1. Google Gemini API (Default): Uses the Gemini 2.0 Flash Experimental model for high-quality image generation

2. Venice.ai API (Optional): Alternative image generation service

3. User-Provided Images: Skip image generation and use your own images

Multi-View Workflow

1. Image Generation: Generate multiple views of the same 3D object

2. Image Approval: Review and approve/deny each generated image

3. 3D Reconstruction: Convert approved images into a 3D model using CUDA MVS

4. Model Refinement: Optionally refine the model using OpenSCAD

Remote Processing Workflow

1. Server Discovery: Automatically discover CUDA MVS servers on your network

2. Image Upload: Upload approved multi-view images to the remote server

3. Job Processing: Process the images on the remote server using CUDA MVS

4. Status Tracking: Monitor the job status and progress

5. Result Download: Download the completed 3D model when processing is finished

Supported Export Formats

• OBJ: Wavefront OBJ format (standard 3D model format)

• STL: Standard Triangle Language (for 3D printing)

• PLY: Polygon File Format (for point clouds and meshes)

• SCAD: OpenSCAD source code (for parametric models)

• CSG: OpenSCAD CSG format (preserves all parametric properties)

• AMF: Additive Manufacturing File Format (preserves some metadata)

• 3MF: 3D Manufacturing Format (modern replacement for STL with metadata)

Web Interface

• Generating and approving multi-view images

• Previewing 3D models from different angles

• Downloading models in various formats

License

Contributing

OpenSCAD MCP Server

Features

• AI Image Generation: Generate images from text descriptions using Google Gemini or Venice.ai APIs

• Multi-View Image Generation: Create multiple views of the same 3D object for reconstruction

• Image Approval Workflow: Review and approve/deny generated images before reconstruction

• 3D Reconstruction: Convert approved multi-view images into 3D models using CUDA Multi-View Stereo

• Remote Processing: Process computationally intensive tasks on remote servers within your LAN

• OpenSCAD Integration: Generate parametric 3D models using OpenSCAD

• Parametric Export: Export models in formats that preserve parametric properties (CSG, AMF, 3MF, SCAD)

• 3D Printer Discovery: Optional network printer discovery and direct printing

Architecture

Installation

1. Clone the repository:

2. Create a virtual environment:

3. Install dependencies:

4. Install OpenSCAD:

5. Install CUDA Multi-View Stereo:

6. Set up API keys:

Remote Processing Setup

Server Setup (on the machine with CUDA GPU)

1. Install CUDA Multi-View Stereo on the server machine:

2. Start the remote CUDA MVS server:

3. The server will automatically advertise itself on the local network using Zeroconf.

Client Configuration

1. Configure remote processing in your .env file:

2. Alternatively, you can specify a server URL directly:

Remote Processing Features

• Automatic Server Discovery: Find CUDA MVS servers on your local network

• Job Management: Upload images, track job status, and download results

• Fault Tolerance: Automatic retries, circuit breaker pattern, and error tracking

• Authentication: Secure API key authentication for all remote operations

• Health Monitoring: Continuous server health checks and status reporting

Usage

1. Start the server:

2. The server will start on http://localhost:8000

3. Use the MCP tools to interact with the server:

Image Generation Options

1. Google Gemini API (Default): Uses the Gemini 2.0 Flash Experimental model for high-quality image generation

2. Venice.ai API (Optional): Alternative image generation service

3. User-Provided Images: Skip image generation and use your own images

Multi-View Workflow

1. Image Generation: Generate multiple views of the same 3D object

2. Image Approval: Review and approve/deny each generated image

3. 3D Reconstruction: Convert approved images into a 3D model using CUDA MVS

4. Model Refinement: Optionally refine the model using OpenSCAD

Remote Processing Workflow

1. Server Discovery: Automatically discover CUDA MVS servers on your network

2. Image Upload: Upload approved multi-view images to the remote server

3. Job Processing: Process the images on the remote server using CUDA MVS

4. Status Tracking: Monitor the job status and progress

5. Result Download: Download the completed 3D model when processing is finished

Supported Export Formats

• OBJ: Wavefront OBJ format (standard 3D model format)

• STL: Standard Triangle Language (for 3D printing)

• PLY: Polygon File Format (for point clouds and meshes)

• SCAD: OpenSCAD source code (for parametric models)

• CSG: OpenSCAD CSG format (preserves all parametric properties)

• AMF: Additive Manufacturing File Format (preserves some metadata)

• 3MF: 3D Manufacturing Format (modern replacement for STL with metadata)

Web Interface

• Generating and approving multi-view images

• Previewing 3D models from different angles

• Downloading models in various formats

License

Contributing