SolidWorks MCP Server 🔧

Automate SolidWorks using natural language through Claude AI and the Model Context Protocol (MCP)

---

🎯 What is This?

SolidWorks MCP Server is a production-ready Model Context Protocol server that lets Claude AI control SolidWorks through natural language. Instead of manually clicking through menus, you simply tell Claude what to design — and it builds it for you.

Example prompts you can use:

• "Create a new part, draw a circle with radius 30mm and extrude it 15mm"
• "Add a fillet of 2mm to all edges"
• "Draw a hexagon and cut extrude it 10mm"
• "List all features in the current part"

---

✨ Features

• ✅ 22 Tools covering parts, sketches, features, and utilities
• ✅ SolidWorks 2023–2025 Compatible with version-aware API fallbacks
• ✅ Auto-detects SolidWorks installation via Windows registry
• ✅ Multi-unit support — mm, cm, inch, meter, foot
• ✅ Modular architecture — clean, extensible Python package
• ✅ Robust error handling — cascading fallback chains for COM API
• ✅ JSON configuration — easy to customize without touching code
• ✅ Comprehensive logging — full debug output for troubleshooting

---

🛠️ Available Tools

Category	Tool	Description
Connection	connect_solidworks	Connect to running SolidWorks instance
Connection	get_solidworks_info	Get version and installation info
Documents	create_new_part	Create a new part document
Documents	create_new_assembly	Create a new assembly document
Documents	open_document	Open an existing SolidWorks file
Documents	close_document	Close the active document
Documents	save_document	Save the active document
Documents	list_open_documents	List all open documents
Sketches	create_sketch	Create a sketch on a plane (Front/Top/Right)
Sketches	close_sketch	Exit the active sketch
Sketches	draw_circle	Draw a circle by center and radius
Sketches	draw_rectangle	Draw a rectangle by two corners
Sketches	draw_line	Draw a line between two points
Sketches	draw_arc	Draw an arc by center and angles
Sketches	draw_polygon	Draw a regular polygon (triangle, hex, etc.)
Features	extrude_sketch	Boss-extrude the active sketch
Features	cut_extrude	Cut-extrude to remove material
Features	fillet_edges	Add fillets to selected edges
Features	chamfer_edges	Add chamfers to selected edges
Features	list_features	List all features in the model
Utilities	set_units	Change default unit (mm/inch/cm/m/ft)
Utilities	execute_python	Execute custom Python code in SW context

---

📋 Requirements

• OS: Windows 10 or Windows 11
• SolidWorks: 2023, 2024, or 2025 (must be installed and licensed)
• Python: 3.10 or higher
• Claude: Claude Desktop app or Claude Code

---

⚡ Quick Start

1. Clone the Repository

git clone https://github.com/alisamsam/solidworks-mcp.git
cd solidworks-mcp

2. Install Dependencies

pip install -r requirements.txt

3. Configure Claude Desktop

Add the following to your claude_desktop_config.json:

Location: C:\Users\YOUR_NAME\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "solidworks": {
      "command": "python",
      "args": ["C:\\path\\to\\solidworks-mcp\\solidworks_mcp_server.py"]
    }
  }
}

4. Launch

1. Open SolidWorks first
2. Restart Claude Desktop
3. In Claude, type: "Connect to SolidWorks"
4. Start designing! 🎉

---

📁 Project Structure

solidworks-mcp/
├── solidworks_mcp_server.py      # Entry point
├── solidworks_mcp/               # Main package
│   ├── __init__.py              # Package exports (v3.0.0)
│   ├── server.py                # MCP server & tool definitions
│   ├── config.py                # Configuration management
│   ├── config.json              # Default settings
│   ├── constants.py             # SolidWorks constants & enums
│   ├── automation/              # Core automation modules
│   │   ├── base.py             # Connection management
│   │   ├── documents.py        # Document operations
│   │   ├── sketches.py         # Sketch operations
│   │   └── features.py         # Feature operations (SW 2025 fixed)
│   └── utils/                   # Utility modules
│       ├── units.py            # Unit conversion system
│       └── sw_finder.py        # Auto-detect SolidWorks
├── requirements.txt
├── .gitignore
└── DEVELOPMENT_ROADMAP.md       # Future development plan

---

⚙️ Configuration

Edit solidworks_mcp/config.json to customize behavior:

{
  "exe_path": "auto",
  "default_unit": "mm",
  "startup_timeout": 120,
  "log_level": "INFO",
  "default_extrude_depth": 10.0,
  "default_fillet_radius": 2.0
}

Setting	Default	Description
exe_path	"auto"	Path to SLDWORKS.exe or auto-detect
default_unit	"mm"	Default unit for all dimensions
startup_timeout	120	Seconds to wait for SW startup
log_level	"INFO"	Logging verbosity

---

🔧 SolidWorks 2025 Compatibility

This server includes special handling for SolidWorks 2025 API changes:

• Extrusion fallback chain: FeatureExtrusion3 → FeatureExtrusion2 → FeatureBossSimple
• Safe property access for feat.Name, feat.GetTypeName2(), IsSuppressed2()
• stdout capture fix for execute_python tool
• Registry-based SolidWorks auto-detection

---

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -m "Add my feature"
4. Push to the branch: git push origin feature/my-feature
5. Open a Pull Request

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

👤 Author

Samsaam Ali Baig

• GitHub: @alisamsam

---

🙏 Acknowledgements

• Anthropic for Claude AI and the MCP framework
• SolidWorks COM API documentation
• Inspired by ros2-claude-code-template by Harun KURT

---

⭐ If this project helps you, please give it a star!