dcc-mcp-freecad
Production FreeCAD adapter for typed, durable parametric modeling and CAD exchange through DCC-MCP.
Illustrative workflow based on the live OpenSCAD → FreeCAD → Blender/Godot acceptance run; generated source is retained in docs/images/dcc-mcp-freecad-showcase-source.png.
Capabilities
- Detect FreeCADCmd and report the actual FreeCAD/Python runtime.
- Create, inspect, recompute, validate, copy, and dependency-safely edit FCStd documents.
- Add and update boxes, cylinders, spheres, cones, and tori with typed dimensions and placements.
- Create parametric union, cut, and intersection features.
- Import or export STEP, IGES, BREP, STL, and OBJ geometry.
- Return object links, placements, shape/mesh topology counts, volume, area, bounding boxes, file size, and SHA-256 provenance.
No arbitrary Python, macros, module paths, or FreeCAD command-line flags are accepted. The adapter invokes only its packaged method-dispatch driver.
Requirements
- Python 3.7+
dcc-mcp-core0.19.91+- FreeCAD 1.0 or newer with
FreeCADCmd/freecadcmd
Install
python -m pip install dcc-mcp-freecad
dcc-mcp-freecad
For development:
python -m pip install -e ".[dev]"
python -m pytest
Configuration
| Variable | Purpose | Default |
|---|---|---|
DCC_MCP_FREECAD_EXECUTABLE |
Exact FreeCADCmd executable or install directory | PATH and standard locations |
DCC_MCP_FREECAD_ALLOWED_ROOTS |
os.pathsep-separated document/import/export roots |
server working directory |
DCC_MCP_FREECAD_MAX_DOCUMENT_BYTES |
Maximum FCStd input size | 2 GiB |
DCC_MCP_FREECAD_MAX_TIMEOUT_SECS |
Maximum per-call deadline | 1800 seconds |
DCC_MCP_FREECAD_PORT |
Fixed adapter port when direct addressing is required | OS-assigned |
The service is a standalone DCC-MCP instance with no GUI PID. Every operation launches a clean FreeCADCmd process in safe mode with a temporary user config.
Agent workflow
dcc-mcp-cli list
dcc-mcp-cli search --query "FreeCAD create boolean export STEP"
dcc-mcp-cli load-skill freecad-session --dcc-type freecad --instance-id <instance-short>
dcc-mcp-cli load-skill freecad-modeling --dcc-type freecad --instance-id <instance-short>
Typical sequence: create_document → add_primitive → transform_object →
boolean_operation → validate_document → export_geometry.
Safety contract
- Requested documents and geometry stay under configured allowed roots.
- Existing outputs require explicit
overwrite=true. - FCStd mutations happen on sibling staging copies and replace the original only after a successful, non-empty save.
- Failed mutations leave the original document byte-for-byte unchanged.
- Object names, dimensional fields, placements, formats, tessellation, result size, process output, and deadlines are bounded.
- Cancellation and timeouts terminate the owned FreeCADCmd process.
- Cascade removal is explicit and reports every removed dependent.
FreeCAD Python API reference: https://www.freecad.org/api/
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dcc_mcp_freecad-0.1.2.tar.gz.
File metadata
- Download URL: dcc_mcp_freecad-0.1.2.tar.gz
- Upload date:
- Size: 20.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b9cc7a06f14e8f08e975ff7c2ad3eb2f09964443aed0c87d8d77bae881a2dc6
|
|
| MD5 |
2c9f8adcef2fda2ea5b3d2071e3d2c74
|
|
| BLAKE2b-256 |
119d1a6f7123fe8557ddc8014142badb7a2cb71db838319f1de321dce9477740
|
Provenance
The following attestation bundles were made for dcc_mcp_freecad-0.1.2.tar.gz:
Publisher:
release.yml on dcc-mcp/dcc-mcp-freecad
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dcc_mcp_freecad-0.1.2.tar.gz -
Subject digest:
4b9cc7a06f14e8f08e975ff7c2ad3eb2f09964443aed0c87d8d77bae881a2dc6 - Sigstore transparency entry: 2437689931
- Sigstore integration time:
-
Permalink:
dcc-mcp/dcc-mcp-freecad@2c9deb63b87a4e1d6c1d8e24bb51eccb64c17a7b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/dcc-mcp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@2c9deb63b87a4e1d6c1d8e24bb51eccb64c17a7b -
Trigger Event:
push
-
Statement type:
File details
Details for the file dcc_mcp_freecad-0.1.2-py3-none-any.whl.
File metadata
- Download URL: dcc_mcp_freecad-0.1.2-py3-none-any.whl
- Upload date:
- Size: 25.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b039012cd6be9ce52ed0bd64b1a9f00a87add9115b61474d17b8a93a51e2f978
|
|
| MD5 |
61627c36aa9500224f8b32f4fd74677d
|
|
| BLAKE2b-256 |
7e9f5ae064ce1aca90fded4240e27f19b6fd0116d4f7eda0c2e5c2d55d286155
|
Provenance
The following attestation bundles were made for dcc_mcp_freecad-0.1.2-py3-none-any.whl:
Publisher:
release.yml on dcc-mcp/dcc-mcp-freecad
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dcc_mcp_freecad-0.1.2-py3-none-any.whl -
Subject digest:
b039012cd6be9ce52ed0bd64b1a9f00a87add9115b61474d17b8a93a51e2f978 - Sigstore transparency entry: 2437690140
- Sigstore integration time:
-
Permalink:
dcc-mcp/dcc-mcp-freecad@2c9deb63b87a4e1d6c1d8e24bb51eccb64c17a7b -
Branch / Tag:
refs/heads/main - Owner: https://github.com/dcc-mcp
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@2c9deb63b87a4e1d6c1d8e24bb51eccb64c17a7b -
Trigger Event:
push
-
Statement type:
