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

The full offline test suite runs against FakeBackend — you do not need SolidWorks installed to develop or verify locally.

Install

pip install pycadmcp

For development (editable + test tools):

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 fake

Replay 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 opencode

Stdio serve (typical for editors):

cadmcp serve --transport stdio --backend fake --profile part

For real SolidWorks, use --backend solidworks on Windows with SolidWorks running.

Capability matrix

134 tools across 9 toolsets (see docs/TOOL_INVENTORY.md):

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 --check

Real SolidWorks (destructive):

# WARNING: closes all open SolidWorks documents WITHOUT saving.
set CADMCP_REAL_SW=1
pytest -q -m sw

Only run real-SW tests on disposable sessions.

Known limitations

License

MIT — Copyright (c) 2026 shiyang19822000.

Not affiliated with Dassault Systèmes. SolidWorks® is a trademark of Dassault Systèmes or its subsidiaries.