cadmcp
Provides integration with Dassault Systèmes SolidWorks for CAD automation, including documents, sketches, basic and advanced features, assemblies, drawings, sheet metal, selection helpers, view orientation/screenshots, and export to STEP/STL/PDF/DXF.
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 · 日本語
Let AI agents (Cursor, Claude, VS Code, OpenCode) drive SolidWorks over MCP: describe a part in plain language, watch the model build, then query mass properties, assemble, detail, and export — without leaving the chat.
Docs: cad.npanic.com — getting started, tools, architecture, FAQ.
What it can do for you
Conversational part modeling — sketch, extrude, fillet, hole wizard, threads, sweeps: ask for "a 100×50×10 plate with four Ø6 through holes" and iterate on dimensions in chat.
Inspect design state — mass properties, geometry, bounding box, feature tree, face/edge queries.
Assemblies — insert components, add mates, component operations.
Drawings & sheet metal — views and annotations, DrawingSpec; base flange / hem / flat pattern.
Export STEP / STL / PDF / DXF from the conversation.
Stay unblocked — when a SolidWorks dialog stalls the session, built-in skills (
solidworks-modeling,solidworks-assembly,solidworks-recovery) andcadmcp doctorguide the agent through recovery.
Related MCP server: SolidworksMCP
Quickstart demo

Prompt: "Create a 100×50×10 mm plate with four Ø6 through holes at the corners." The agent made these calls (real session):
new_part {}
start_sketch {"plane": "Front Plane"}
sketch_rectangle {"x1": 0, "y1": 0, "x2": 100, "y2": 50}
end_sketch {}
extrude {"depth": 10}
hole_wizard {"face": 4, "diameter": 6, "end": "through_all", "x": 10, "y": 10}
hole_wizard {"face": 4, "diameter": 6, "end": "through_all", "x": 90, "y": 10}
hole_wizard {"face": 4, "diameter": 6, "end": "through_all", "x": 10, "y": 40}
hole_wizard {"face": 4, "diameter": 6, "end": "through_all", "x": 90, "y": 40}
get_mass_properties {}get_mass_properties reports 48,869 mm³ — 50,000 minus four Ø6 holes, exactly
as requested.
Requirements
Setup | Needs |
SolidWorks backend (real modeling) | Windows + SolidWorks 2025 running + Python 3.11+ + |
Fake backend (try MCP wiring without SolidWorks) | Python 3.11+, any OS — connectivity check only, no real modeling |
Install
pip install pycadmcpCLI entry point: cadmcp.
Connect to an AI client
Both transports are supported: stdio (the client spawns the server — recommended for editors and agents) and HTTP (a long-running local server; also handy for debugging and monitoring).
stdio (recommended)
One command writes the server entry for Cursor, Claude Desktop, VS Code, or OpenCode:
cadmcp install --client cursor # or: claude | vscode | opencode
cadmcp install --client cursor --dry-runThat writes a server entry named solidworks. Equivalent manual JSON:
{
"mcpServers": {
"solidworks": {
"command": "cadmcp",
"args": ["serve", "--transport", "stdio", "--backend", "solidworks", "--profile", "part"]
}
}
}Use "--backend", "fake" when SolidWorks is not installed.
HTTP (Streamable HTTP)
Start the server once and point URL-based clients at it:
cadmcp serve --transport http --backend solidworks
# listens on 127.0.0.1:8756 — MCP endpoint http://127.0.0.1:8756/mcpHTTP is authenticated by default: a token is auto-created at
%APPDATA%\cadmcp\token(Windows) or~/.config/cadmcp/token(POSIX); send it asAuthorization: Bearer <token>.--host/--portadjust the bind;--allow-insecuredisables auth on loopback only (non-loopback binds always require the token).GET /healthreturns executor state for monitoring (no auth required).
Client config for URL-based clients:
{
"mcpServers": {
"solidworks": {
"url": "http://127.0.0.1:8756/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}First result, and when things stall
Restart the client, open a chat, and ask for the plate from the demo above.
Health check: cadmcp doctor --backend solidworks (or --backend fake
without SolidWorks). If the agent reports a stuck executor, ask it to run
cadmcp doctor — the recovery skill (cadmcp://skill/solidworks-recovery)
walks through clearing SolidWorks dialogs.
Optional scripted demo (from a repo clone): copy examples/box_recipe.json
into the workspace and run replay_recipe.
Capability overview
163 tools across 15 toolsets (see docs/TOOL_INVENTORY.md):
Toolset | Count | Focus |
core | 48 | Documents, sketches, basic features, queries |
features_adv | 27 | Thread, helix, sweep, surfaces, feature ops |
assembly | 24 | Insert, mates, component ops (cam mate BLOCKED) |
drawing | 21 | Views, annotations, DrawingSpec, verification |
sketch_adv | 12 | Splines, offset/trim, constraints, dims |
sheetmetal | 8 | Base/flange/miter, hems, flat pattern, DXF |
selection | 6 | Face/edge pick helpers |
transaction | 4 | L1 checkpoint/journal + L2 reload/compensate/discard |
task | 3 | Batch task execution |
design | 3 | DesignSpec intent (validate only) |
export | 2 | STEP/STL + PDF/DXF |
view | 2 | Orientations / screenshots |
rules | 1 | Machine-checkable model rules |
verification | 1 | Model verification checks |
diagnostics | 1 | Interpret |
Skills (solidworks-modeling, solidworks-assembly, solidworks-recovery)
ship as cadmcp://skill/... resources. solidworks-modeling is also published
standalone on Agensi.
Known limitations
Limitation | Notes |
Mold Core/Cavity | Blocked pending reliable parting-surface / license context — #1 |
Thread Feature (geometry) | Shipped as |
SolidWorks Toolbox | Not integrated — #3 |
Part in-context edit ( | Not supported; subassembly edit is — #4 |
Axial screw-in / feed mate motion | Not supported |
Architecture in three facts
SolidWorks COM runs only on a dedicated STA thread; business code never creates COM connections itself.
An offline-testable Fake backend implements the same protocol, so the full test suite runs without SolidWorks.
Every tool returns a typed OpResult envelope (
ok/error.code/delta/state_version).
Details: ARCHITECTURE.md. Naming history: docs/naming.md.
Development
git clone https://github.com/pakupaku5260/cad-mcp.git
cd cad-mcp
pip install -e ".[dev]"Offline tests, the architecture gate, HTTP debugging, and (destructive) real-SolidWorks test runs are documented in CONTRIBUTING.md; system design in ARCHITECTURE.md.
License
MIT — Copyright (c) 2026 pakupaku5260.
Independent project, not affiliated with Dassault Systèmes · SOLIDWORKS® is a registered trademark of Dassault Systèmes SolidWorks Corporation.
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.
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Verified component catalog over remote MCP: agents pick component ids and get a stamped project repo that builds. Connect at https://www.botkelp.com/mcp. Auth: MCP OAuth 2.1, or a Bearer bk_live_ API key; initialize and tools/list are open.
Discover, plan and run tools across your connected business systems through one OAuth MCP endpoint
Related MCP Servers
- 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 for controlling a live SOLIDWORKS session through the Windows COM API, enabling native CAD operations like sketches, features, bodies, views, and exports, plus transactional plans and vectorization.11MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that controls SolidWorks via COM, enabling CAD automation with 138 tools for sketching, 3D features, assemblies, drawings, and more.MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to inspect, edit in memory, rebuild, render, and export SOLIDWORKS 2016+ parts, assemblies, and drawings on the same PC or in a Windows VM. It provides 13 tools with read-only defaults and controlled export/save behavior.279 npm5MIT