Repository navigation
Releases
v3.1.3
What's Changed
- Use version from package.json by @budnik in #3
- Update README.md by @budnik in #2
- Fix SolidWorks tooling: Improve macros, drawings, and error handling by @vespo92 in #7
- v3.1.0: Fix SelectByID2 COM type mismatch, cleanup dead code by @vespo92 in #13
- Fix #14: Hardcoded path, honest docs, Biome, test fixes by @vespo92 in #15
- Fix TS2589 type recursion error in zodToJsonSchema by @MSURocketryClub in #18
- Fix create_extrusion COM type mismatch with VBA macro fallback by @vespo92 in #19
New Contributors
- @budnik made their first contribution in #3
- @MSURocketryClub made their first contribution in #18
Full Changelog: v3.0.6...v3.1.3
v3.0.6 - Fixed COM Object Creation
π― THE FIX: Properly Load winax Module
What Was Wrong
The winax module sets global.ActiveXObject when loaded via require(), but we were using ES6 import which doesn't trigger this initialization.
The Solution
Use createRequire from Node's module system to properly load winax:
const require = createRequire(import.meta.url);
const winax = require('winax');This ensures global.ActiveXObject is available, matching exactly how the working Windows installation loads winax.
π§ What's Fixed
- β COM object creation now works - SolidWorks operations should execute properly
- β Uses the exact pattern from the working winax module
- β
Simplified COM object factory to prioritize
global.ActiveXObject - β Maintains compatibility with all winax versions
π¦ Installation
# Clear any cached versions first
npx clear-npx-cache
# Then install/update
npm install -g solidworks-mcp-server@3.0.6Or run directly:
npx solidworks-mcp-server@3.0.6π Technical Details
The winax module's activex.js contains:
global.ActiveXObject = function(id, opt) {
return new ActiveX.Object(id, opt);
};This only executes when the module is loaded via CommonJS require(), not ES6 import.
Previous Fixes Included
- v3.0.2: Fixed Winston logger stdout interference
- v3.0.3: Fixed Zod to JSON Schema conversion
- v3.0.4-3.0.5: Initial attempts at COM object creation fixes
v3.0.5 - Robust COM Object Creation Fix
π§ Critical Fixes
Windows COM Compatibility (v3.0.5)
- β Fixed "createActiveXObject is not a function" error that prevented all SolidWorks operations
- β Implemented robust multi-pattern COM object factory supporting all winax versions
- β Added automatic detection for winax.Object, global ActiveXObject, and legacy patterns
- β Created compatibility layer for legacy code expectations
Previous Fixes Included
- β Fixed Winston logger stdout interference with MCP protocol (v3.0.2)
- β Fixed Zod to JSON Schema conversion for tool visibility in Claude Desktop (v3.0.3)
- β Resolved winax module import issues (v3.0.4)
π Installation
npm install -g solidworks-mcp-server@3.0.5Or run directly:
npx solidworks-mcp-server@3.0.5π― What This Fixes
This release ensures the MCP server works correctly with SolidWorks regardless of:
- Which version of winax is installed
- How the winax module exports its functions
- What Windows/Node.js architecture you're using
- Previous working configurations from other machines
π Technical Details
The new COM object factory tries multiple methods in order:
new winax.Object()- Standard API for winax 3.xnew ActiveXObject()- If winax made it global- Direct
winax()call - Some older versions winax.createActiveXObject()- Legacy/custom wrapper support
This ensures maximum compatibility across all environments where SolidWorks automation is needed.
v3.0.0 - Clean Architecture & Enhanced Tools
π Major Release: v3.0.0
This release represents a complete architectural overhaul with enhanced functionality for SolidWorks automation.
β¨ What's New
ποΈ Clean Architecture Refactoring
- Complete refactoring following Clean Architecture principles
- Implementation of SOLID principles throughout the codebase
- Domain-driven design with clear separation of concerns
- Repository pattern for data access
- Command/Query pattern (CQRS-lite) implementation
- Dependency injection via Service Locator
π¨ Template Management System
- Extract drawing templates from parent files
- Batch apply templates to multiple child drawings
- Comprehensive template data extraction including:
- Sheet formats and sizes
- Custom properties
- Dimension and annotation styles
- View layouts and positions
- Template library management with categorization
π¬ Native Macro Recording
- Native SolidWorks VBA macro recording using COM API
- Proper VBA project initialization with all required references
- Fixes issue where MCP-created macros wouldn't run
- Support for:
- Recording, pausing, and stopping macros
- Batch macro execution
- Macro validation and debugging
- VBA code generation with proper SolidWorks initialization
βοΈ Comprehensive Sketch Tools (30+ functions)
- Complete sketch plane creation and management
- Full geometry creation suite (lines, circles, arcs, splines, etc.)
- Advanced constraints and relations
- Pattern creation (linear, circular, mirror)
- Sketch analysis and validation
π§ Improvements
- Fixed all TypeScript compilation errors
- Enhanced error handling and recovery
- Better COM object management
- Improved build configuration
π¦ Installation
npm install -g solidworks-mcp-server@3.0.0β οΈ Breaking Changes
- Refactored internal architecture may affect custom integrations
- Some tool names have been standardized
π Bug Fixes
- Fixed macro recording initialization issues
- Resolved template extraction errors
- Corrected COM object access patterns
π Notes
- Ensure SolidWorks macro security is set to "Low" for proper operation
- VBA features require SolidWorks 2020 or later
π€ Generated with Claude Code
v2.2.0 - Critical Windows Fixes
π SolidWorks MCP Server v2.2.0
This release incorporates critical Windows fixes verified on production SolidWorks installations.
π§ Major Fixes
- Handlebars Helper Registration - Fixed VBA generation tools failing with "Missing helper" errors
- Template Name Mismatch - Resolved batch_export template mapping issues
- Rebuild Model API - Multiple fallback methods for different SolidWorks versions
- Close Model Error Handling - Safe COM object access preventing crashes
- Export File Robustness - Format-specific handling with retry logic
- Mass Properties Extraction - Comprehensive error recovery
β¨ New Features
- Added batch_export.vba template for batch operations
- Debug scripts for troubleshooting (debug-server.mjs, debug-wrapper.mjs)
- Comprehensive testing checklist (SWChecklist.md)
- Enhanced error handling across all API methods
π¦ Installation
npm install -g solidworks-mcp-server@2.2.0π Links
Full Changelog: v2.1.0...v2.2.0
v2.1.0 - Comprehensive VBA Generation Suite
SolidWorks MCP Server v2.1.0
π Major Release: Comprehensive VBA Generation Suite
This release transforms the SolidWorks MCP Server into a complete VBA generation powerhouse with over 3,300 lines of new code across 5 specialized modules.
β¨ What's New
Part Modeling VBA Generation
- Reference geometry creation (planes, axes, points, coordinate systems)
- Advanced features (sweep, loft, boundary, wrap, flex, deform)
- Pattern features (linear, circular, curve-driven, fill, variable)
- Sheet metal operations (base flange, edge flange, hem, jog, fold)
- Surface modeling (extrude, revolve, sweep, loft, offset, thicken, knit)
Assembly Automation VBA
- Complete mate types including advanced mates (cam, gear, rack & pinion)
- Component management (insert, replace, pattern, mirror, explode)
- Assembly analysis (interference detection, mass properties, BOM export)
- Configuration management with suppression states
Drawing Automation VBA
- Comprehensive view creation (standard, section, detail, auxiliary)
- Smart dimensioning with tolerances
- Annotations (GD&T, surface finish, weld symbols, balloons)
- Table generation (BOM, revision, hole tables, cutlists)
- Sheet format and title block management
File Management & PDM
- Batch operations across entire folders
- Custom property management at scale
- PDM vault operations (check in/out, state changes)
- Design table automation with SQL integration
- Pack and Go automation
Advanced Features
- Configuration-specific suppression states
- Equation and global variable management
- Simulation study setup (static, frequency, thermal)
- API automation and event handling
- Comprehensive error handling and logging
π οΈ Technical Improvements
- Fixed TypeScript compilation errors
- Added @types/dotenv for proper type support
- Corrected template string interpolation in VBA generation
- CI/CD now stable with Node 20.x
π¦ Installation
npm install -g solidworks-mcp-serverπ― Perfect For
- IT/CAD Managers automating workflows
- Engineers needing batch operations
- Teams standardizing processes
- Anyone automating SolidWorks without VBA knowledge
π Full Changelog
See CHANGELOG.md for complete details.
v2.0.1 - Repository URL Fix
π§ Patch Release
- Fixed repository URLs to point to correct GitHub repository (vespo92/SolidworksMCP-TS)
- Updated package.json with correct homepage and issues URLs
NPM Package
The npm package now correctly references:
- Repository: https://github.com/vespo92/SolidworksMCP-TS
- Issues: https://github.com/vespo92/SolidworksMCP-TS/issues
- Homepage: https://github.com/vespo92/SolidworksMCP-TS#readme
No functional changes in this release.