Repository navigation
Releases
0.20.0
Read-only tools no longer pull their document to the front, and drawings work on SOLIDWORKS in other languages. 88 tools.
Changed
- Tools that only read leave SOLIDWORKS' active document alone (list_features, list_dimensions, read_sketch, list_equations, list_faces, list_edges, list_bodies, get_mass_properties, get_bounding_box, check_printability, list_components, check_interference, measure_distance, get_assembly_bounding_box). A person or another session working in the same SOLIDWORKS keeps the window they are in. Sketching, features, exports and screenshots still activate it, and so does
measure_distanceto an axis, which draws a temporary sketch line. The history snapshot every call takes reads without activating too. Thanks to @Stef33fr (#11). - A read still keeps its document's view still while it works: that is the guard against SOLIDWORKS 2026 SP4.0's random crash in its user interface.
Fixed
make_drawingcould not place the isometric view on a SOLIDWORKS in another language: it asked for the view named*Isometric, which a French SOLIDWORKS calls*Isométrique. It now picks the standard view that looks isometric, whatever its name.
See the changelog for details.
0.19.0
Holes and bosses that keep their distance to the edges. 88 tools.
Added
add_hole_on_face(..., from_edges=True)andadd_boss_on_face(..., from_edges=True)dimension the centre from the face's nearest straight edges instead of the origin, so the hole or boss keeps its distance to them when the part changes, as a person would draw it.measured_fromnames the edges. A face without straight edges along both sketch axes is refused, and no sketch is left behind.
Changed
- The guide shows how to make features follow each other: tie a hole to its block with an equation, so it stays centred or a fixed distance from an edge when the block grows, or measure it from the edges with
from_edges.
See the changelog for details.
0.18.0
Lofts in any direction, planes that move along in a reorder, and design-intent rules for the agent. 88 tools.
Added
loft_sketches(sketches)lofts through closed sketches on any planes, in order (add_plane, then add_sketch on it, or a person's sketches), so a loft can run in any direction;add_lofted_solidstacks only along +Z.reorder_featuremoves the reference planes and axes a feature is built on along with it (moved_along). A turned plane stands on a reference axis made after it, so moving it earlier in the tree was refused before.
Changed
- The connect-time instructions gain a "Design intent" section: plan the feature tree first, change a shape where it is made instead of stacking bodies and cuts at the end of the tree, extrude details up to the surface they meet, stop and say so when an operation is missing or refused, and measure what a hand calculation cannot judge.
- The Z-up template message and the README say how to get Y-up parts: choosing Y-up in the New Document dialog is not used for parts made through the API, so save a Y-up part as a part template and set that file as the default part template. Thanks to the reporter of #8.
Fixed
slice_meshfailed with "No running SolidWorks found" while SolidWorks was gone, though it only reads an STL or 3MF. It now runs without SolidWorks.
See the changelog for details.
0.17.0
3D printing checks that see where a print starts in the air, a tool to replace a component, and several guards against long or crashing calls. 87 tools.
Added
check_printabilityfinds where a print starts in the air, also where no face leans past the overhang limit.islands: a point, edge or patch lower than all around it with nothing beneath.unsupported_edges: stretches of an edge the material rises from with air right below, such as the ends of a chamfered pad's edge that rests on a tube only in the middle. Each comes with its height above the bed, where it is and its faces.replace_component(name, path)puts another file in a component's place, keeping its position and, where they find their faces, its mates.list_componentsflags a component that shows no geometry.add_shellopens several faces at once: directions and list_faces indexes,["+z", "#5"].set_dimensionnames the features it breaks inbroken_features(a later cut now off the part, a split whose bodies moved).list_dimensions(contains=...)filters by name or feature, for parts of hundreds of features.cut_profile_through_planeandadd_extruded_profile_on_planealso take the points as [u, v] in the plane's own frame.
Fixed
- [u, v] points given where [x, y, z] were expected took SolidWorks down. The points' shape is now checked before any sketch opens.
- The wall-thickness check could outlast the 2-minute call limit and return nothing. It now stops after a minute with the rays spread over all faces, and says how many it measured.
- A STEP, IGES or Parasolid import over 30 MB is refused unless
allow_large=True: a 77 MB STEP ran past the call limit and kept SolidWorks busy, with popups.
See the changelog for details.
0.16.3
English material names work on a SolidWorks in any language. 86 tools.
Fixed
set_materialrefused '6061 Alloy', 'AISI 1020' and the other English names on a SolidWorks in another language, whose material database names its materials in that language. An English name is now found there by its material id, which is the same in every language; the localized name still works too. A name that is not found gets the closest names in the error.
See the changelog for details.
0.16.2
Screenshots show the part again. 86 tools.
Fixed
screenshotsaved a blank, all-white image since 0.16.0 (about 1 kB), while it reported success. The view that is kept still against the SOLIDWORKS 2026 SP4.0 crash was stilled again just before the picture was written. The view now draws for the whole screenshot; every other tool stays still. A test now checks that the picture holds the part. Thanks to the reporter, who traced it to the line.
See the changelog for details.
0.16.1
A clearer message for Z-up part templates, and corrected sweep docs. 86 tools.
Changed
- A part from a Z-up template is refused with a message that says so. Since SOLIDWORKS 2025 new parts can be Z-up; that turns all three default planes, and the tools build in SolidWorks' standard Y-up frame. Before, every tool stopped with a vague "The part has no front plane ... Is its template unusual?". The message now names the Z-up template and how to make new parts Y-up, and the README lists a Y-up part template as a requirement.
Fixed
- The
add_swept_profiledocs gave the profile's axes wrong. On the Right plane u runs along world -Z and v along +Y, not +Y and +Z, so an off-centre profile landed elsewhere than the docs said. A test now pins where it lands.
See the changelog for details.
0.16.0
Two fixes: SOLIDWORKS 2026 SP4.0 no longer crashes while a tool sketches, and parts are built on the right plane whatever the order of the planes in your part template. 86 tools.
Fixed
- SOLIDWORKS 2026 SP4.0 crashed at random while a tool sketched, mostly at the very first sketch: an access violation in its user interface (slduiu.dll). Every tool call now keeps SolidWorks' window still while it works (no view, feature tree or sketch redraws until it is done, together with CommandInProgress) and shows everything again afterwards. In hundreds of tool calls since, it did not crash. The selftest runs its checks the same way. Drawing by hand in SolidWorks was never affected.
- With some part templates every part came out turned. The first reference plane in a new part was taken as the Front plane; in a template that holds its planes in another order, every block was built on another plane, and the tools that look for a face by its direction (
+x,+z) missed it. The Front, Top and Right planes are now found by where they lie, through the origin with their own axes.
If you ran the selftest before and some checks failed, please run it again and tell us the result:
uvx --refresh solidworks-mcp@latest --selftest
See the changelog for details.
0.15.0
Chamfers at any angle, colours and see-through for parts and components, and refusals that say how large a round fits. 86 tools.
Added
- Chamfers at any angle.
add_chamfer(1, "-z:outline", angle_deg=60, from_face="-z")leaves an underside edge at 60 degrees, printable without support; round an arc the chamfer is a cone. SolidWorks picks one of an edge's two faces by itself, so the chamfer is measured and made again the other way round when it took the wrong one. - Colours and see-through.
set_appearance(rgb=[30, 30, 30], component="Frame-1")colours a component in an assembly while the part file keeps its own colour;transparency=0.6shows what lies behind a cover,transparency=0makes it solid again. Without a component it colours the current part.
Fixed
- An assembly left editing one of its parts (a double click in SolidWorks) showed every other component see-through, and
insert_componentfailed with "AddComponent5 returned None". Every tool now edits the assembly as a whole again first. - A refused fillet now says how large a round fits. An edge that "fails even alone" comes with the largest radius it takes, found by trial to 0.01 mm.
See the changelog for details.
0.14.0
Move a feature to its place in the history, joints that turn below 0, extrusions that end on a chosen face, and STL files that stay where the model is. 85 tools.
Added
- Move a feature in the history. Every tool adds its feature at the end, so a plate drawn over holes cut earlier closed them, and only the volume showed it.
reorder_feature("Plate", before="Hole1")moves it, with its sketch, before the first of them, and they cut through it again. A move before something the feature is built on is refused and names it. - Joints below 0 degrees. An angle mate is made at 0..180 between two faces, but its dimension turns the joint the whole way round. Negative values now work too in
set_dimension,check_motionandswept_region: a joint of -35..115 steps as it is, from any pair of side faces. - End an extrusion on a chosen face.
extrude_sketch(up_to="@x,y,z")ends on the face through that point. Up to next fails when a side of the profile lies on a face of the part, such as a strip against a boss; that refusal now says so and names a point on the face ahead to use instead. - See what a delete takes along.
delete_feature(dry_run=True)lists it without deleting.
Changed
- STL exports keep the model's coordinates, also one file per component, where SolidWorks moved them into positive space. A mesh measured back now lines up with the part, and files per component line up with the assembly; the result names the
frame. Slicers place the part on the bed anyway.
Fixed
delete_featurenamed only part of what it would delete: the features built directly on the one to delete, not what was built on those, whichwith_children=Truedeleted as well. The refusal now names everything that goes.- A failed STEP import could leave documents behind, open, hidden and unsaved. A failed or refused import now closes every document it opened.
- SolidWorks now and then ignores a new dimension value, at random (about 1 in 25 on a fresh part), so
set_dimensionrefused a plain value andcheck_motionstopped at a step. The value is now written once more when the old one reads back; a value SolidWorks refuses is still refused.
See the changelog for details.