SolidWorks

sw-mcp

让 AI Agent（Claude 或任何其他 MCP 客户端）在你自己的 SolidWorks 中设计零件、装配体和工程图，并在过程中检查设计成果。每完成一步，它都会测量结果，以便与需求进行比较并修正错误，而不是凭空猜测。

sw-mcp 是 Henk Jan Baard 开发的 SolidWorks-MCP 和 Jig 的 SolidWorks 连接器的分支。它适用于任何 MCP 客户端。

功能

• 零件： 草图、拉伸、旋转、扫描和放样；可在任意面上创建孔、螺纹、槽和凹槽；圆角、倒角、抽壳、肋、阵列和镜像。每个草图都完全定义，因此零件始终可编辑。
• 检查： 每一步都会报告体积、质量和尺寸；并测量尺寸和配合。无法完成的步骤会明确说明原因，而不是生成错误几何体。read_model 可通过一次调用读取整个零件以供检查：包括孔及其尺寸、内部半径、尖锐的内角、装夹、薄壁和拔模。
• 钣金： 基体法兰（平板凸缘或弯折成 L、U、Z 形的截面）以及边线法兰，并可指定厚度、弯曲半径和 K 因子；提供展开毛坯尺寸，并可将带折弯线的展开图导出为 DXF，用于激光切割。闭合角可直接用于焊接。
• 焊缝和焊件： 在实体之间创建完整或断续焊缝；使用库中的管材、管件、角钢和槽钢截面创建框架，支持斜接或对接角、端盖和加强板；生成包含各构件长度和总焊缝长度的切割清单。
• 装配体： 插入并放置零部件、添加配合、替换零件、检查干涉，并检查阶梯接头在整个运动范围内的情况。
• 工程图： 带标题栏的 ISO 图纸、视图、剖视图和详图、尺寸标注、孔标注、表面粗糙度和 GD&T 符号、表格，以及导出为 PDF、DXF 或 DWG。钣金零件会生成带折弯线、折弯说明和毛坯尺寸的展开图；焊件会显示焊接符号和切割清单。
• 自定义零件： 打开现有零件和 STEP 文件、修改尺寸和方程式、设置材料，并基于你绘制的草图继续设计。
• 3D 打印和导出： 导出 STEP、STL 和 3MF，生成屏幕截图，检查可打印性，并将零件与扫描网格进行比较。

开始使用

1. 安装 uv。

2. 启动 SolidWorks 并保持打开。

3. 将服务添加到 MCP 客户端。在 Claude Code 中：

   claude mcp add solidworks -- uvx sw-mcp
   

   Claude Desktop 或其他客户端

   {
     "mcpServers": {
       "solidworks": {
         "command": "uvx",
         "args": ["sw-mcp"]
       }
     }
   }
   

   使用 Jig 时无需添加任何内容：插件会自行启动 sw-mcp。

4. 提出零件设计需求：

   设计一块 100 × 80 × 8 mm 的安装板，中心有一个 Ø16 mm 通孔，四角各有一个距角点 12 mm 的沉孔 M5 螺孔，圆角为 R5。然后导出 STL。

   或者设计钣金件：

   制作一个 2 mm 厚的钢制托盘，尺寸为 80 × 50 mm，长边带 20 mm 翻边，内侧弯曲半径为 3 mm。请提供 DXF 格式的展开图和 PDF 格式的工程图。

   或者设计焊接框架：

   用 30 × 30 × 2.6 方管焊接一个 600 × 400 mm 的框架，采用斜接角，封闭开口端，并提供切割清单和工程图。

要求

• 安装并运行 SolidWorks 的 Windows 系统。服务会连接已打开的 SolidWorks，不会启动它。

• 已在 SOLIDWORKS 2026 上测试。2020 及更新版本应该可以运行，但未经测试。

• 要检查设置，请在 SolidWorks 运行时执行以下命令。它会构建几个小型测试零件，并在不保存的情况下关闭它们：

  uvx sw-mcp --selftest
  

需要了解的信息

• **早期版本（0.x）：**端到端流程可正常运行，但工具名称仍可能变更。 请参阅更新日志。
• **本地运行：**它只与计算机上的 SolidWorks 通信，不会进行网络调用。
• 默认启用脚本：run_script 会在计算机上运行传入的任意 Python 代码。启动服务时使用 --no-scripts 可将其关闭。
• **多实体零件：**面和边工具只能查看第一个实体； read_model 会读取所有实体。

帮助与反馈

遇到问题？请提交错误报告，并附上 uvx sw-mcp --selftest 的输出。使用的 SolidWorks 版本不是 2026？无论是否运行成功，都欢迎提交兼容性报告。

致谢与许可证

MIT，详见 LICENSE。 原始服务由 Henk Jan Baard 开发 (hjbaard/SolidWorks-MCP)；此分支由 Nejc Dvorsek 维护。