SolidWorks MCP Server

通过 MCP 协议连接 Claude Code 和 SolidWorks，实现自然语言控制 SolidWorks 画图。

工作原理

用户自然语言 → Claude Code → MCP Server → SolidWorks COM API → 3D 模型

环境要求

• Windows 10/11
• SolidWorks 2020 或更高版本
• Python 3.10+
• Claude Code CLI

安装步骤

1. 克隆项目

git clone <your-repo-url>
cd solidworks-mcp

2. 安装依赖

pip install -r requirements.txt

3. 配置 Claude Code

在项目根目录创建 .claude/settings.json：

{
  "mcpServers": {
    "solidworks": {
      "command": "python",
      "args": ["-m", "server.mcp_server"],
      "cwd": "<项目绝对路径>"
    }
  }
}

或者在全局配置 ~/.claude/settings.json 中添加同样的配置。

使用方法

1. 启动 SolidWorks

确保 SolidWorks 已经打开。

2. 启动 Claude Code

claude

3. 开始对话

直接用自然语言描述你要画什么：

基础操作：

• "帮我创建一个新零件"
• "在前视基准面画一个 100x50 的矩形"
• "拉伸 30mm"
• "保存到 D:\models\test.sldprt"

进阶操作：

• "画一个直径 50 高 80 的圆柱"
• "在顶面开一个直径 10 的通孔"
• "对所有边做半径 5 的圆角"
• "把这个特征镜像到右边"

复合操作：

• "画一个 100x50x30 的长方体，在顶面中心开一个直径 8 的通孔，然后对所有边做圆角"

支持的 MCP Tools

Tool	功能
sw.new_part	创建新零件
sw.new_assembly	创建新装配体
sw.new_drawing	创建新工程图
sw.open	打开现有文档
sw.save	保存文档
sw.export_step	导出 STEP
sw.close	关闭文档
sw.new_sketch	创建草图
sw.draw_line	画线段
sw.draw_circle	画圆
sw.draw_arc	画弧
sw.draw_rectangle	画矩形
sw.draw_center_rectangle	画中心矩形
sw.draw_polygon	画正多边形
sw.exit_sketch	退出草图
sw.extrude	拉伸凸台
sw.cut_extrude	拉伸切除
sw.revolve	旋转
sw.fillet	圆角
sw.chamfer	倒角
sw.shell	抽壳
sw.mirror	镜像
sw.linear_pattern	线性阵列
sw.circular_pattern	圆周阵列
sw.add_plane	创建基准面
sw.add_axis	创建基准轴
sw.delete_feature	删除特征
sw.undo	撤销
sw.add_dimension	尺寸标注
sw.zoom_to_fit	缩放至适合
sw.rebuild	重建模型
sw.get_model_info	获取模型信息
sw.list_features	列出特征

故障排除

无法连接 SolidWorks

1. 确保 SolidWorks 已启动
2. 检查 SolidWorks 版本是否支持 COM 自动化
3. 以管理员权限运行 Python

MCP Server 启动失败

1. 检查 Python 版本：python --version
2. 检查依赖是否安装：pip list | grep mcp
3. 检查 cwd 路径是否正确

操作执行失败

1. 检查草图是否封闭
2. 检查尺寸参数是否合理
3. 使用 sw.get_model_info 查看当前状态

开发

项目结构

solidworks-mcp/
├── .claude/skills/solidworks.md   # Skill 定义
├── server/
│   ├── __init__.py
│   ├── mcp_server.py              # MCP Server 入口
│   └── sw_api.py                  # SolidWorks COM 封装
├── requirements.txt
├── pyproject.toml
└── README.md

扩展新功能

1. 在 sw_api.py 中添加新的 API 方法
2. 在 mcp_server.py 中注册对应的 MCP tool
3. 在 .claude/skills/solidworks.md 中更新操作指南