SolidCraft MCP
An MCP server for CAD modeling in SolidCraft: the agent builds parametric 3D parts, measures volume, looks at a screenshot and exports to STEP
- 11,834 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- Can read, overwrite and delete files in allowed folders: the open design, the recovery folder and paths from `--allow-path`; the `--allow-any-path` flag lifts the limit
- Runs the engine on the GPU and executes any CAD command through `execute` and `batch`, while `new_design` and `open` discard unsaved work
Install
- Works in
Manual install
claude mcp add solidcraft -- solidcraft-cli mcpNeeds the solidcraft-cli executable on PATH. Headless mode, screenshots are drawn on the GPU or in software.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Can read, overwrite and delete files in allowed folders: the open design, the recovery folder and paths from `--allow-path`; the `--allow-any-path` flag lifts the limit
- Runs the engine on the GPU and executes any CAD command through `execute` and `batch`, while `new_design` and `open` discard unsaved work
This is third-party code. Review the repository files before installing.
What it does
SolidCraft is an open parametric CAD application in Rust for desktop and browser, and `solidcraft-cli mcp` is its MCP server for 3D modeling. The agent builds a part with the same engine commands that the toolbar, scripts and the control channel use: a sketch with dimensions and constraints, extrude, revolve, fillets, shell, holes, patterns, parameters with formulas. The server never opens a dialog. There are fifteen tools. `list_commands`, `execute`, `batch` and `inspect_design` handle browsing and editing, `measure` and `body_topology` check the result, `set_parameter` changes a size, `screenshot` returns an image and `export` writes a file. The rest are `undo`, `redo`, `new_design`, `open`, `save` and `crash_reports`. A `batch` runs whole or rolls back to the start, and the reply names the step that failed. The server has two modes. The headless one starts with `solidcraft-cli mcp` and keeps its own session with no window, drawing screenshots on the GPU. The bridged one starts with `--connect 127.0.0.1:PORT` and drives an open app launched with `solidcraft --control PORT`, so you watch the agent model.
Who it is for. For designers, engineers and 3D-printing makers who want an agent to build parametric parts such as brackets and enclosures and check them with numbers.
Good fit when
- You need an enclosure, bracket, flange or plate with parameters: the agent sets the sizes, and changing a height in the parameters table rebuilds the whole part
- The result must be checked with numbers: `measure` returns volume, area, center of mass and bounding box, and the agent compares them with its own calculation
- You want to watch the agent model: start the app with `--control` and attach the server with `--connect`
- The part is needed as STEP, STL, 3MF or OBJ for production or printing, and an assembly with joints can be exported to URDF
Not a fit when
- You need industrial accuracy with no caveats: the project is early, and its checks do not establish full geometric equivalence
- You work in FreeCAD: it has its own freecad-mcp, while SolidCraft has its own engine and the `.solidcraft` format
- You need drawings in AutoCAD or GstarCAD: CAD-MCP Server fits that
- You need photorealistic rendering: HDRI, refraction and texture maps are not implemented in the application
- Your project folder lies outside the home folder or in a hidden one: the server blocks access there until you add `--allow-path`
Example request
Build a Raspberry Pi 4 case in SolidCraft with length, width and height parameters, fillets, standoffs for mounting and port cut-outs, check the volume and export to STEPMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
SOLIDCRAFT_CONTROL_TOKENsecret- Control channel token of the app, used in bridged mode when the server cannot see the app's data folder
SOLIDCRAFT_GPU- Chooses how screenshots are drawn: auto, hardware, software or cpu
Limitations
- The project status is early but usable for simple parts. Of 76 public reference parts 75 matched analytic or FreeCAD-computed values, and the last one is a tracked bug. These checks do not establish complete geometric equivalence.
- The `execute`, `batch`, `open`, `save`, `export` and `screenshot` tools with a path can read, overwrite and delete files, so they are marked destructive. The server lets them reach only the open design's folder inside your home folder, the recovery folder and paths from `--allow-path`. The `--allow-any-path` flag lifts the limit.
- The bridged mode takes the token from the app's file or from `SOLIDCRAFT_CONTROL_TOKEN`. The app writes a screenshot to a temporary file and the server reads it from disk, so both processes must run on the same machine.
- Installers are not signed yet: SmartScreen on Windows warns, and on macOS you open the app through the context menu the first time. A separate `solidcraft-cli` archive in release 0.15.0 exists for macOS, and for other systems the documentation describes a source build through `cargo`.
- The license is MIT or Apache-2.0 at your option. The project is independent and not affiliated with Autodesk.
How to disable. Run `claude mcp remove solidcraft` or delete the `solidcraft` block from `.mcp.json` or `claude_desktop_config.json` and restart the client. If you copied the skills, delete the `solidcraft-modeling`, `solidcraft-editing`, `solidcraft-checking` and `solidcraft-mechanisms` folders from `~/.claude/skills/`. Saved `.solidcraft` files stay on disk.
FAQ
How do I connect SolidCraft to Claude Code for 3D modeling?
Put `solidcraft-cli` somewhere on your path and run `claude mcp add solidcraft -- solidcraft-cli mcp`. For Claude Desktop add a server to `claude_desktop_config.json` with the command `solidcraft-cli` and the arguments `mcp`, `--connect` and the address of the running app.
Can I watch the agent model in the SolidCraft window?
Yes. Start the app with `solidcraft --control 7878` and attach the server with `--connect 127.0.0.1:7878`. The server finds the token in the file the app writes for that port, and for a sandboxed app `SOLIDCRAFT_CONTROL_TOKEN` provides it.
Which agent skills ship with SolidCraft?
The `skills/` folder holds four skills: `solidcraft-modeling` for a new part, `solidcraft-editing` for changing an existing one, `solidcraft-checking` for checks and porting, and `solidcraft-mechanisms` for assemblies with joints and motion. For Claude Code you copy them into `~/.claude/skills/`. With them an agent builds a part in a few `batch` calls.
Which files on my computer can the agent reach through SolidCraft?
Only the open design's folder when it lies inside your home folder and is not hidden, SolidCraft's recovery folder and the paths from `--allow-path`. Folders such as `~/.ssh` and `~/.aws` stay out of reach, links and `..` are resolved before the path check, and on Windows network and device paths are refused.
How do I check that a part was built correctly?
Call `measure`: it returns volume in mm³, area, center of mass, bounding box and face, edge and vertex counts. The skills advise computing the expected numbers in advance and comparing each stage, and `body_topology` helps pick edges and faces for fillets by coordinates.
Discussion
No questions or reviews yet.
Related
MCP serversHosted MCP server for the PartMode browser CAD that lets an agent edit parametric parts, assemblies and drawings
SourceCraft MCP and CLI: repos and CI/CD
SourceCraft MCP Server
An MCP server, CLI tool and skill for Yandex's SourceCraft development platform: repositories, issues, pull requests, CI/CD and releases, 48 tools
SolidWorks Automation Skill
solidworks-automation-skill
A skill and an MCP toolkit for automating desktop CAD (SolidWorks, AutoCAD): the agent calls the real program and checks the result. Windows, README in Chinese
The experimental Structurizr MCP server: validates a C4 model in DSL, exports views to Mermaid and PlantUML and manages workspaces on a server
A plugin with skills for building TypeScript MCP servers and MCP apps: the agent scaffolds, edits, debugs and verifies them
An MCP server for PCB design in KiCAD: the agent places components, routes connections, runs DRC and prepares manufacturing files
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| SolidCraft (this entry) | yes | not required | 11,834 | |
| FreeCAD MCP | no | not required | 3,108 | drives an installed FreeCAD through an add-on and an RPC server and runs Python code inside it |
| CAD-MCP Server | no | not required | 653 | draws and edits drawings in AutoCAD, GstarCAD and ZWCAD in plain words |
| text-to-cad | no | 24,136 | a library of skills for CAD, CAE and CAM with STEP, STL and 3MF export and g-code slicing |
README in short
The repository front page opens with download buttons for Windows, macOS, Linux and the browser, then lists capabilities: sketches with a constraint solver, a parametric feature timeline, assemblies, sheet metal, export and import formats, the desktop app and the `solidcraft-cli` command line. The agents section describes the MCP server, and the `skills/` folder holds four skills with install instructions. A roadmap, documentation as a book and reference-part checks sit alongside.