OpenSCAD MCP Server

A Model Context Protocol (MCP) server that gives AI assistants the ability to render, export, and analyze 3D models using OpenSCAD. Built with FastMCP for Python.

Prerequisites

• OpenSCAD installed on your system
• uv (recommended) or Python 3.10+

Installation

Claude Code

Add the server with a single command:

claude mcp add openscad --transport stdio -- \
  uv run --with git+https://github.com/quellant/openscad-mcp.git openscad-mcp

Or, if OpenSCAD is not on your PATH:

claude mcp add openscad --transport stdio \
  --env OPENSCAD_PATH=/path/to/openscad -- \
  uv run --with git+https://github.com/quellant/openscad-mcp.git openscad-mcp

Use the --scope flag to control where the configuration is saved:

Scope	Flag	Effect
Local (default)	--scope local	Available only to you in the current project
Project	--scope project	Shared with the team via .mcp.json
User	--scope user	Available to you across all projects

Claude Desktop

Add to your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "openscad": {
      "command": "uv",
      "args": [
        "run",
        "--with", "git+https://github.com/quellant/openscad-mcp.git",
        "openscad-mcp"
      ],
      "env": {
        "OPENSCAD_PATH": "/usr/bin/openscad"
      }
    }
  }
}

Then restart Claude Desktop.

Cursor / Windsurf / VS Code

Add a .mcp.json file to your project root:

{
  "mcpServers": {
    "openscad": {
      "command": "uv",
      "args": [
        "run",
        "--with", "git+https://github.com/quellant/openscad-mcp.git",
        "openscad-mcp"
      ]
    }
  }
}

Manual / Standalone

# Run directly from GitHub (no install required)
uv run --with git+https://github.com/quellant/openscad-mcp.git openscad-mcp

# Or clone and run locally
git clone https://github.com/quellant/openscad-mcp.git
cd openscad-mcp
uv run openscad-mcp

Available Tools

Rendering

Tool	Description
render_single	Render a single view with camera control, quality presets, and view presets
render_perspectives	Render multiple standard views (front, back, left, right, top, bottom, isometric) in parallel
compare_renders	Side-by-side before/after renders for visual comparison

Export & Model Management

Tool	Description
export_model	Export to STL, 3MF, AMF, OFF, DXF, or SVG
create_model	Create a new .scad file in the workspace
get_model	Read a model file and its metadata
update_model	Update an existing model's content
list_models	List all models in the workspace
delete_model	Delete a model file

Analysis & Validation

Tool	Description
validate_scad	Syntax-check code without a full render (errors, warnings, echo output)
analyze_model	Compute bounding box, dimensions, and triangle count via STL export
get_libraries	Discover installed OpenSCAD libraries
check_openscad	Verify OpenSCAD installation and version

Project Support

Tool	Description
`get_project_fi

... View full README on GitHub