How alisamsam/solidworks-mcp works
SolidWorks MCP Server exposes SolidWorks operations as MCP tools: a Claude-compatible client requests connection, document, sketch, feature, or utility actions; the server dispatches tool calls into the automation package, which operates on SolidWorks through Windows COM. The documented workflow moves from opening or creating a document, through sketch geometry and 3D features, to querying or saving the model. The README also documents unit handling and installation detection. Simulation exists as a separate top-level module, but its wiring to the MCP server is not established by the sampled excerpts; it is shown as an optional integration. Some internal operation-module relationships are based on the documented modular structure, not inspected call sites.
Main entry points: __init__.py Automation Facade · server.py MCP Tool Server · units.py Unit Conversion · base.py COM Connection
Components 15
MCP Interface
- MCP Tool Server
solidworks_mcp/server.py
Model Automation
- Automation Facade
solidworks_mcp/automation/__init__.py - COM Connection
solidworks_mcp/automation/base.py - Documents
solidworks_mcp/automation/documents.py - Sketch Geometry
solidworks_mcp/automation/sketches.py - Model Features
solidworks_mcp/automation/features.py
Configuration Utilities
- Unit Conversion
solidworks_mcp/utils/units.py - SW Detection
solidworks_mcp/utils/sw_finder.py - Configuration
solidworks_mcp/config.py - API Constants
solidworks_mcp/constants.py
Simulation
- Simulation API
solidworks_simulation.py - COM Helper
solidworks_com.py
Other components
- Claude Client
- SolidWorks
- Simulation Add-in
Connections 19
- Claude Client → MCP Tool Server: calls tools
- MCP Tool Server → Automation Facade: dispatches actions
- MCP Tool Server → Unit Conversion: sets units
- MCP Tool Server → Configuration: loads settings
- Automation Facade → COM Connection: manages connection
- Automation Facade → Documents: dispatches document actions
- Automation Facade → Sketch Geometry: dispatches sketch actions
- Automation Facade → Model Features: dispatches feature actions
- Documents → Unit Conversion: converts dimensions
- Sketch Geometry → Unit Conversion: converts geometry
- Model Features → Unit Conversion: converts dimensions
- COM Connection → SW Detection: detects installation
- COM Connection → SolidWorks: connects via COM
- Documents → SolidWorks: operates documents
- Sketch Geometry → SolidWorks: creates geometry
- Model Features → SolidWorks: creates features
- Simulation API → COM Helper: uses COM helper
- COM Helper → SolidWorks: connects via COM
- Simulation API → Simulation Add-in: loads add-in