Render a single view from OpenSCAD code or file.

Args: scad_content: OpenSCAD code to render (mutually exclusive with scad_file) scad_file: Path to OpenSCAD file (mutually exclusive with scad_content) view: Predefined view name ("front", "back", "left", "right", "top", "bottom", "isometric", "dimetric") camera_position: Camera position - accepts [x,y,z] list, JSON string "[x,y,z]", or dict {"x":x,"y":y,"z":z} (default: [70, 70, 70]) camera_target: Camera look-at point - accepts [x,y,z] list, JSON string, or dict (default: [0, 0, 0]) camera_up: Camera up vector - accepts [x,y,z] list, JSON string, or dict (default: [0, 0, 1]) image_size: Image dimensions - accepts [width, height] list, JSON string "[width, height]", "widthxheight", or tuple (default: [800, 600]) color_scheme: OpenSCAD color scheme (default: "Cornfield") variables: Variables to pass to OpenSCAD auto_center: Auto-center the model quality: Quality preset - "draft" (fast, low detail), "normal" (OpenSCAD defaults), or "high" (slow, high detail). User-provided variables override quality preset values. include_paths: Additional include paths for OpenSCAD via the OPENSCADPATH environment variable, enabling multi-file project support ctx: MCP context for logging

Returns: List containing the rendered PNG image and metadata

Render multiple standard views of an OpenSCAD model in a single call.

Renders the model from several predefined camera perspectives in parallel, returning all images at once. Useful for generating a comprehensive visual overview of a 3D model.

Args: scad_content: OpenSCAD code to render (mutually exclusive with scad_file) scad_file: Path to OpenSCAD file (mutually exclusive with scad_content) views: List of view names to render. Valid names: "front", "back", "left", "right", "top", "bottom", "isometric". If not specified, renders all standard views. image_size: Image dimensions - accepts "widthxheight", "width,height", "[width, height]", or [width, height] list (default: [800, 600]) color_scheme: OpenSCAD color scheme (default: "Cornfield") variables: Variables to pass to OpenSCAD via -D flags quality: Quality preset - "draft" (fast, low detail), "normal" (OpenSCAD defaults), or "high" (slow, high detail). User-provided variables override quality preset values. include_paths: Additional include paths for OpenSCAD via the OPENSCADPATH environment variable, enabling multi-file project support ctx: MCP context for logging

Returns: List of rendered PNG images and metadata

Verify OpenSCAD installation and return version info.

Args: include_paths: Include searched paths in response ctx: MCP context for logging

Returns: Dict with OpenSCAD installation information

Export OpenSCAD code or file to STL, 3MF, AMF, OFF, DXF, or SVG.

Args: scad_content: OpenSCAD code to export (mutually exclusive with scad_file) scad_file: Path to OpenSCAD file (mutually exclusive with scad_content) output_format: Export format - "stl", "3mf", "amf", "off", "dxf", or "svg" (default: "stl") output_path: Path to write the exported file. If not specified, a temp directory is used. variables: Variables to pass to OpenSCAD via -D flags include_paths: Additional include paths for OpenSCAD via the OPENSCADPATH environment variable ctx: MCP context for logging

Returns: Dict with success status, output_path, format, and file_size_bytes

Create a new OpenSCAD model file.

Args: name: File name for the model (alphanumeric, hyphens, underscores; .scad extension added automatically if missing) content: OpenSCAD source code for the model workspace: Directory to save the model in. Defaults to the configured temp_dir/models directory. ctx: MCP context for logging

Returns: Dict with success status, path, and name of the created file

Read an OpenSCAD model file and return its contents.

Args: name: File name of the model to read workspace: Directory containing the model. Defaults to the configured temp_dir/models directory. ctx: MCP context for logging

Returns: Dict with success status, name, content, path, and size_bytes

Update an existing OpenSCAD model file with new content.

The file must already exist. Use create_model to create new files.

Args: name: File name of the model to update content: New OpenSCAD source code for the model workspace: Directory containing the model. Defaults to the configured temp_dir/models directory. ctx: MCP context for logging

Returns: Dict with success status, path, and name of the updated file

List all OpenSCAD model files in the workspace directory.

Args: workspace: Directory to list models from. Defaults to the configured temp_dir/models directory. ctx: MCP context for logging

Returns: Dict with success status, list of models (name, path, size_bytes, modified), and count

Delete an OpenSCAD model file from the workspace.

The file must exist. Returns the path of the deleted file.

Args: name: File name of the model to delete workspace: Directory containing the model. Defaults to the configured temp_dir/models directory. ctx: MCP context for logging

Returns: Dict with success status, name, and deleted_path

Syntax-check OpenSCAD code without performing a full render.

Runs OpenSCAD with output directed to /dev/null (NUL on Windows) so it only parses and evaluates the code without generating geometry output. Much faster than a full render. Captures and categorizes ECHO, WARNING, ERROR, and DEPRECATED messages from stderr.

Args: scad_content: OpenSCAD code to validate (mutually exclusive with scad_file) scad_file: Path to OpenSCAD file to validate (mutually exclusive with scad_content) variables: Variables to pass to OpenSCAD via -D flags include_paths: Additional include paths for OpenSCAD via the OPENSCADPATH environment variable ctx: MCP context for logging

Returns: Dict with success status, valid flag, errors list, warnings list, echo_output list, and deprecated list

Extract geometric information from an OpenSCAD model.

Exports the model to a temporary STL file, then parses vertex data to compute bounding box, dimensions, center point, and triangle count. The temporary STL is cleaned up after parsing.

Args: scad_content: OpenSCAD code to analyze (mutually exclusive with scad_file) scad_file: Path to OpenSCAD file to analyze (mutually exclusive with scad_content) variables: Variables to pass to OpenSCAD via -D flags include_paths: Additional include paths for OpenSCAD via the OPENSCADPATH environment variable ctx: MCP context for logging

Returns: Dict with success status, bounding_box (min/max xyz), dimensions (width/height/depth), center point, and triangle_count

Discover installed OpenSCAD libraries on the system.

Searches standard OpenSCAD library paths for the current platform, plus the OPENSCADPATH environment variable. For each found library directory, lists subdirectories as libraries and reports file counts, README presence, and main entry files.

This is a read-only operation that does not require OpenSCAD to be installed.

Args: ctx: MCP context for logging

Returns: Dict with success status, library_paths searched, and libraries list with name, path, file_count, has_readme, and main_files for each library

Render two versions of a model for visual comparison.

Supports two modes:

1. Two different SCAD contents: provide scad_content_before and scad_content_after.

2. Same file with different variables: provide scad_file with variables_before and variables_after.

Both versions are rendered in parallel for efficiency. Uses the existing render_scad_to_png helper and QUALITY_PRESETS.

Args: scad_content_before: OpenSCAD code for the "before" version scad_content_after: OpenSCAD code for the "after" version scad_file: Path to OpenSCAD file (used with variable diffs) variables_before: Variables for the "before" render variables_after: Variables for the "after" render view: View preset name (default: "isometric"). Valid names: "front", "back", "left", "right", "top", "bottom", "isometric", "dimetric" image_size: Image dimensions - accepts "widthxheight", "width,height", "[width, height]", or [width, height] list (default: [800, 600]) quality: Quality preset - "draft", "normal", or "high" (default: "draft") ctx: MCP context for logging

Returns: List with before/after images and metadata

Delete all cached render files and report freed space.

Removes every .png file from the configured cache directory. Does nothing (and still reports success) when the cache is disabled or the directory does not exist.

Args: ctx: MCP context for logging

Returns: Dict with success status, cleared_files count, and freed_bytes

List all OpenSCAD files in a project directory and map their dependencies.

Recursively finds every .scad file under project_dir, parses each file for include and use statements, and returns a structured overview of the project's file tree and dependency graph.

Args: project_dir: Root directory of the OpenSCAD project. Validated against security.allowed_paths when configured. ctx: MCP context for logging

Returns: Dict with success status, files list (each with name, path, size_bytes, modified), and dependencies mapping (relative path to list of dependency strings).