SolidWorks MCP Server

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

工作原理

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

Related MCP server: SolidWorks MCP Server

环境要求

• 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

故障排除

无法连接 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 中更新操作指南