OpenSCAD

Provides an MCP server that renders PNG previews and exports STL geometry from OpenSCAD source for agent-driven CAD workflows.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fboldo-openscad-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "openscad-mcp-server"
      ]
    }
  }
}

OpenSCAD MCP Server renders PNG previews and STL geometry from OpenSCAD source, enabling iterative, agent-driven CAD workflows where you can visually verify models and export concrete geometry for downstream use.

How to use

You integrate this MCP server with your MCP client to render previews and export geometry from OpenSCAD code. Use the render_scad_png tool to generate a PNG preview from SCAD source, optionally providing image dimensions and camera settings. Use the export_scad_stl tool to create an STL file from SCAD source, with an optional filename.

How to install

Prerequisites: ensure you have Node.js installed (which provides npm or an equivalent package manager). You will run the MCP server via an npx command as shown in the configuration example.

Configure the MCP client to use the server by adding the following MCP configuration snippet. This config runs the MCP server through npx for stdio communication.

{
  "mcpServers": {
    "openscad": {
      "command": "npx",
      "args": ["-y", "openscad-mcp-server"]
    }
  }
}

Local development

The server is designed to run over stdio. You can test and develop locally using the commands below.

bun install
bun index.ts --stdio

Notes

The MCP server is in beta, so performance, APIs, and features may change. This server focuses on rendering OpenSCAD previews and exporting geometry to support iterative, agent-driven workflows.

Security and testing considerations

If you run the HTTP interface for manual testing, you can access health and MCP endpoints as described in your client integration. Ensure you validate inputs to prevent unexpected SCAD execution in production environments.

Available tools

render_scad_png

Renders a PNG preview image from SCAD source. Inputs include scadCode, optional width and height, optional cameraPreset, and optional cameraPosition; outputs an MCP ImageContent.

export_scad_stl

Exports an STL generated from SCAD source. Inputs include scadCode and optional filename; outputs an embedded STL resource.