cadmcp
Automates Dassault Systèmes' SolidWorks CAD application through a dedicated STA-threaded COM backend: 134 tools spanning documents and sketches, basic and advanced features (threads, helix, sweep, surfaces), assemblies and mates, drawings with views and annotations, sheet metal and flat patterns, selection helpers, view orientation/screenshots, and export to STEP/STL/PDF/DXF. Includes design-recipe replay, skill resources for modeling/assembly/recovery workflows, and an offline Fake backend for testing without SolidWorks installed.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
cadmcp
Languages: English · 简体中文 · Deutsch · 日本語
CAD MCP server: one process, a dedicated STA executor, and an offline-testable Fake backend — SolidWorks backend first.
Not affiliated with Dassault Systèmes. SolidWorks® is a trademark of Dassault Systèmes or its subsidiaries. This project is an independent community MCP server.
Requirements
Mode | Needs |
Fake backend (default for CI) | Python 3.11+, Windows/macOS/Linux |
SolidWorks backend | Windows + SolidWorks 2025 (ProgID |
The full offline test suite runs against FakeBackend — you do not need SolidWorks installed to develop or verify locally.
Related MCP server: SolidWorks MCP Server
Install
Source install only for now (PyPI deferred):
git clone https://github.com/shiyang19822000/cad-mcp.git
cd cad-mcp
python -m venv .venv
# Windows PowerShell:
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"CLI entry point: cadmcp.
Quick start
Health check (Fake):
cadmcp doctor --backend fakeReplay a design recipe from the workspace (Fake):
# Copy examples/box_recipe.json into your workspace, then via MCP tool:
# replay_recipe(path="box_recipe.json")
# Or drive the same tools interactively through an MCP client.Install into a local MCP client (writes server key solidworks):
cadmcp install --client opencode --dry-run
cadmcp install --client opencodeStdio serve (typical for editors):
cadmcp serve --transport stdio --backend fake --profile partFor real SolidWorks, use --backend solidworks on Windows with SolidWorks running.
Capability matrix
134 tools across 9 toolsets (see docs/TOOL_INVENTORY.md):
Toolset | Count | Focus |
core | 45 | Documents, sketches, basic features, queries |
features_adv | 25 | Thread, helix, sweep, surfaces, feature ops |
assembly | 20 | Insert, mates, component ops |
drawing | 16 | Views, annotations, DrawingSpec |
sketch_adv | 12 | Splines, offset/trim, constraints, dims |
sheetmetal | 7 | Base/flange/hem, flat pattern |
selection | 6 | Face/edge pick helpers |
view | 2 | Orientations / screenshots |
export | 1 | STEP/STL/PDF/DXF |
Skills (solidworks-modeling, solidworks-assembly, solidworks-recovery)
ship as cadmcp://skill/... resources.
Architecture (summary)
Protocol layer shared by Fake and SolidWorks backends.
SolidWorks COM runs only on a dedicated STA thread; business code never creates COM connections itself.
Tool results use a typed OpResult envelope (
ok/error.code/delta/state_version).
Details: ARCHITECTURE.md. Naming history: docs/naming.md.
Testing
Offline (default):
ruff check .
pytest -q
python scripts/tool_inventory.py --checkReal SolidWorks (destructive):
# WARNING: closes all open SolidWorks documents WITHOUT saving.
set CADMCP_REAL_SW=1
pytest -q -m swOnly run real-SW tests on disposable sessions.
Known limitations
Limitation | Notes |
Mold Core/Cavity | Blocked pending reliable parting-surface / license context — #1 |
Native InsertThread API | Helix + sweep cut path is used instead — #2 |
SolidWorks Toolbox | Not integrated — #3 |
Part in-context edit ( | Not supported; subassembly edit is — #4 |
Axial screw-in / feed mate motion | Not supported |
License
MIT — Copyright (c) 2026 shiyang19822000.
Not affiliated with Dassault Systèmes. SolidWorks® is a trademark of Dassault Systèmes or its subsidiaries.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Email inboxes, webhook URLs, mock APIs and 170+ tools for coding agents over one MCP connection.
Hosted MCP endpoint with realistic fake data for prototyping agents. 12 tools, no setup.
Related MCP Servers
- AlicenseAqualityBmaintenancePython MCP server for SolidWorks automation with 109 tools covering the full CAD lifecycle. Enables AI-assisted design workflows through COM automation on Windows.156665 PyPI108MIT
- AlicenseNot gradedqualityDmaintenanceEnables natural language control of SolidWorks 2024 through MCP, providing 87 tools for sketch, drawing, and model operations with an intelligent COM bridge that handles parameter limits.18MIT
- AlicenseBqualityDmaintenanceEnables connecting MCP clients to local SolidWorks for automated 3D part creation, template generation, file export, and basic review via natural language.104MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that controls SolidWorks via COM, enabling CAD automation with 138 tools for sketching, 3D features, assemblies, drawings, and more.MIT