# solidworksMCPToolkit

**Repository Path**: AchieveMiniMax/solidworks-mcptoolkit

## Basic Information

- **Project Name**: solidworksMCPToolkit
- **Description**: 通过 MCP（Model Context Protocol） 把 SolidWorks 2026 开放给 AI 智能体，让自然语言驱动的 CAD 建模、装配、工程图与参数化验证成为可能。智能体发出一条工具调用，服务器即在 SolidWorks 中完成对应操作并返回结构化 JSON 结果。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-11
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SolidWorks MCP 建模工具套件

一套完整的 SolidWorks 自动建模解决方案：**双 MCP 服务器（源码）+ 三个配套 Skills**，打包于 2026-08-10。

## 目录结构

```
SolidWorks-MCP-Toolkit/
├── mcp/
│   ├── solidworks-mcp-hjbaard/     # hjbaard 服务器（36+ 工具，SW2026 已验证）
│   │                                #   - 基础体：box/cylinder/cone/disc/revolve/loft
│   │                                #   - 切除：hole/cut/slot/revolve
│   │                                #   - 特征：fillet/chamfer/pattern/shell
│   │                                #   - 验证：mass_properties/bounding_box/rebuild
│   └── solidworks-mcp-unified/     # unified 服务器（91 工具，推荐首选）
│                                    #   - 全部常规建模 + 装配 + 工程图 + 验证
│                                    #   - 草图实体：line/arc/circle/polygon/spline
│                                    #   - 旋转/切除/孔/倒角/圆角/阵列/螺旋线
│                                    #   - 2026-08-10 修复：旋转特征支持 axis='z'
└── skills/
    ├── solidworks-mcp-toolkit/     # 工具速查手册（权威工具参考与 COM 陷阱）
    ├── solidworks-modeling-engineer/  # 高级建模工程师技能
    └── solidworks-atomic-modeling/    # 原子化分步建模 SOP
```

## 两套服务器定位

| 服务器 | 前缀 | 工具数 | 强项 | 何时用 |
|---|---|---|---|---|
| solidworks-unified ⭐ | `sw_` | 91 | 一切常规建模/装配/验证；旋转/切除/孔/草图/约束 | **默认首选** |
| solidworks-hjbaard | `add_`/`cut_`/`list_` | 38 | 基础体与验证 | unified 不可用兜底 |

两套连接**同一个 SolidWorks 实例**（COM），共享文档与特征树，可交替调用。

## 环境要求

- Windows + SolidWorks 2026（类型库版本 34.x）
- Python 3.10+，`pip install pywin32`（虚拟环境）

## 安装与配置

### 1. 初始化虚拟环境（每个服务器目录内）

```bash
cd mcp/solidworks-mcp-unified
python -m venv .venv
.venv\Scripts\pip install pywin32
.venv\Scripts\pip install -e .

cd ..\solidworks-mcp-hjbaard
python -m venv .venv
.venv\Scripts\pip install pywin32
```

### 2. 注册到 WorkBuddy MCP（~/.workbuddy/mcp.json）

```json
{
  "mcpServers": {
    "solidworks-unified": {
      "type": "stdio",
      "command": "C:\\...\\SolidWorks-MCP-Toolkit\\mcp\\solidworks-mcp-unified\\.venv\\Scripts\\python.exe",
      "args": ["-m", "sw_unified.server"],
      "cwd": "C:\\...\\SolidWorks-MCP-Toolkit\\mcp\\solidworks-mcp-unified",
      "disabled": false
    },
    "solidworks-hjbaard": {
      "type": "stdio",
      "command": "C:\\...\\SolidWorks-MCP-Toolkit\\mcp\\solidworks-mcp-hjbaard\\.venv\\Scripts\\python.exe",
      "args": ["-m", "solidworks_mcp.server"],
      "cwd": "C:\\...\\SolidWorks-MCP-Toolkit\\mcp\\solidworks-mcp-hjbaard",
      "disabled": false
    }
  }
}
```

> 配置后在连接器管理页右上角对新增服务器点击「信任」启用。修改服务器源码后需**重启 MCP 连接器**才生效。

### 3. 安装 Skills（复制到 ~/.workbuddy/skills/）

```bash
cp -r skills/* ~/.workbuddy/skills/
```

## 2026-08-10 修复记录（本次打包包含）

unified 服务器两处真实 bug 已修复：

1. **`sw_add_revolved_profile` 新增 `axis` 参数**
   - 原实现旋转轴固定绕 **Y 轴**，与拉伸（Z 轴）冲突，旋转体无法叠加到拉伸基体顶部
   - 现支持 `axis='y'`（默认，兼容旧调用）/ `axis='z'`（绕世界 Z 轴，与拉伸同向）
   - 用法：`sw_add_revolved_profile(profile_mm=[[r,z],...], axis='z')`

2. **`sw_revolve_cut` 参数修正**
   - `FeatureRevolve2` 的 gen_py 签名无 Flip/Dir，第 2 参数为 `IsSolid`、第 4 参数为 `IsCut`
   - 修正了参数错位（多余的一对 `False, False`），旋转切除现在正确对齐

### 已知限制（COM 桥不可用）

- CreateLine 多边形轮廓 + 旋转（FeatureRevolve2）在 SW2026 下无法生成实体（返回 None 或生成曲面）；`CreateCornerRectangle` 矩形轮廓可用
- 拔模/圆顶/筋/镜像/移动体等 API 在 COM 桥缺失（有替代方案，见 toolkit skill）
- 装配插入组件、参考轴/点创建等不可用

## Skills 使用

- **solidworks-mcp-toolkit**：先读这份（工具参数、COM 陷阱、轴向约定）
- **solidworks-atomic-modeling**：复杂零件按"一调一特征、先验证后继续"SOP 执行
- **solidworks-modeling-engineer**：参数化建模/装配/工程图的完整工程师流程