convez.ai
MCP ServerAutomaçãoAvançado
alisamsam

SolidWorks MCP Server

alisamsam/Solidworks-MCP

Automatize SolidWorks por comandos em linguagem natural com Claude

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que automatiza SolidWorks via linguagem natural através do Claude AI. Oferece 22 ferramentas para criar e manipular peças, sketches, features e realizar operações de design parametrizado sem interação manual com menus.

Instalação

$npx convez-ai alisamsam/Solidworks-MCP

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
210
Forks
44
Acompanhando
5
Saúde
42%
Último commit
há 8 meses
Versão
—
Issues abertas
7
Contribuidores
1

Casos de uso

  • Criar peças e features parametrizadas via prompt ao invés de clicar menus
  • Gerar designs repetitivos (cilindros, polígonos, filetes) com uma instrução
  • Integrar geração de modelos 3D em fluxos de trabalho automatizados

Veredito

Solução robusta e bem-documentada para automação de CAD via IA. Requer SolidWorks licenciado e Windows, mas entrega valor real para fluxos de design parametrizados e repetitivos em ambiente corporativo.

README

A tradução para o português deste README ainda está na fila.

SolidWorks MCP Server 🔧

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

License: MIT Python 3.10+ SolidWorks 2025 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

CategoryToolDescription
Connectionconnect_solidworksConnect to running SolidWorks instance
Connectionget_solidworks_infoGet version and installation info
Documentscreate_new_partCreate a new part document
Documentscreate_new_assemblyCreate a new assembly document
Documentsopen_documentOpen an existing SolidWorks file
Documentsclose_documentClose the active document
Documentssave_documentSave the active document
Documentslist_open_documentsList all open documents
Sketchescreate_sketchCreate a sketch on a plane (Front/Top/Right)
Sketchesclose_sketchExit the active sketch
Sketchesdraw_circleDraw a circle by center and radius
Sketchesdraw_rectangleDraw a rectangle by two corners
Sketchesdraw_lineDraw a line between two points
Sketchesdraw_arcDraw an arc by center and angles
Sketchesdraw_polygonDraw a regular polygon (triangle, hex, etc.)
Featuresextrude_sketchBoss-extrude the active sketch
Featurescut_extrudeCut-extrude to remove material
Featuresfillet_edgesAdd fillets to selected edges
Featureschamfer_edgesAdd chamfers to selected edges
Featureslist_featuresList all features in the model
Utilitiesset_unitsChange default unit (mm/inch/cm/m/ft)
Utilitiesexecute_pythonExecute 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
}
SettingDefaultDescription
exe_path"auto"Path to SLDWORKS.exe or auto-detect
default_unit"mm"Default unit for all dimensions
startup_timeout120Seconds 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


🙏 Acknowledgements


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

Ver o original no GitHub

Bom para

Relacionados