OpenSCAD MCP Server (jhacksman)

MCP serverCommunity

A local OpenSCAD server that turns SCAD code or primitive sizes into editable SCAD, STL and four PNG previews. By jhacksman.

214 starsUpdated 2 months agoGitHub data from 5 Nov 2026

At a glance

Type: MCP server
Works with: OpenSCAD
How it connects: Reads and writes files; the tool isn't needed
Access: Can modify models
Tool versions: Not stated in its documentation
Operating systems: Windows, macOS, Linux
Needs a OpenSCAD licence: No
Transport: Local (stdio), Remote (HTTP)
AI clients documented: Not stated in its documentation
Licence: MIT
Language: Python

What it can do

Renders OpenSCAD source or explicit primitive dimensions to STL and four preview images.
Tracks revisions so a stale edit fails instead of overwriting a newer one.
Runs over stdio by default or Streamable HTTP at http://127.0.0.1:8000/mcp, with preview pages and downloads in HTTP mode; a headless Docker image is available.

Limitations

Requires Python 3.11+ and OpenSCAD; headless Linux rendering may need xvfb-run.
The earlier image-generation and reconstruction code has been archived and is not supported.

Install

git clone https://github.com/jhacksman/OpenSCAD-MCP-Server.git
cd OpenSCAD-MCP-Server
uv sync --locked
uv run openscad-mcp --help

Source: github.com/jhacksman/OpenSCAD-MCP-Server#install

{
  "mcpServers": {
    "openscad": {
      "command": "/absolute/path/to/venv/bin/openscad-mcp",
      "args": ["--output-dir", "/absolute/path/to/models"]
    }
  }
}

Source: github.com/jhacksman/OpenSCAD-MCP-Server#connect-an-mcp-client

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.