Schema

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
`OPENSCAD_PATH`	No	Path to OpenSCAD executable	/usr/bin/openscad
`MCP_SERVER_NAME`	No	MCP server name	openscad-mcp
`OPENSCAD_TIMEOUT`	No	Timeout for rendering operations (seconds)	30
`MCP_SERVER_VERSION`	No	MCP server version	1.0.0
`MCP_SERVER_TRANSPORT`	No	Transport: stdio, sse, or http	stdio
`MCP_RENDER_DEFAULT_WIDTH`	No	Default image width	800
`MCP_RENDER_DEFAULT_HEIGHT`	No	Default image height	600
`MCP_RENDER_MAX_CONCURRENT`	No	Max concurrent renders	4

Schema

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
`get_server_info`	Get server configuration and capabilities.

Tools

Functions exposed to the LLM to take actions

Name	Description
render_single	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 output_format: Output format - "auto", "base64", "file_path", or "compressed" (default: "auto") ctx: MCP context for logging Returns: Dict with base64-encoded PNG image or file path
check_openscad	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

Name

Description

render_single

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 output_format: Output format - "auto", "base64", "file_path", or "compressed" (default: "auto") ctx: MCP context for logging

Returns: Dict with base64-encoded PNG image or file path

check_openscad

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

Server Configuration

Prompts

Resources

Tools

MCP directory API