FullyDefined – AI for SOLIDWORKS

FullyDefined – 用于 SOLIDWORKS 的 AI

一个 SolidWorks MCP 服务，可让 Claude、Gemini/Antigravity 和其他 AI 应用构建完全定义的 SOLIDWORKS 零件、装配体和工程图。

安装方法：从 Releases 页面下载 FullyDefined-Setup-<version>.exe，双击运行，勾选要使用的 AI 应用，然后点击 Install。

让 AI 助手能够构建和检查 SolidWorks 模型。你用日常语言描述零件；助手使用此服务的工具驱动 SolidWorks，并通过测量模型来检查每个结果。适用于运行本地 MCP 服务的 AI 应用。

**已测试：**使用 Claude Opus 和 Claude Sonnet 模型的 Claude Desktop 和 Claude Code；已在 Antigravity 上安装并使用。其他应用和模型由你自行选择：它们应该也能运行，但效果可能不如上述应用和模型（欢迎反馈）。

功能

• **零件：**根据你提供的尺寸创建完全定义的草图（线条、圆弧、圆形、矩形、多边形、槽）；拉伸、切除、旋转、扫掠、放样、圆角、倒角、抽壳、镜像、线性和圆周阵列、孔向导孔、参考基准面、曲面、材料、颜色和方程式。
• **钣金和焊件：**基体法兰、边线法兰和斜接法兰、标签、卷边、草图折弯、成形工具、展平和平板展开 DXF；结构构件及其切割清单。
• **装配体：**添加、移动、固定、隐藏、替换和删除组件；配合（添加、编辑、压缩、删除）；干涉检查；爆炸视图。
• **工程图：**标准视图、剖视图和详图视图、尺寸、气球注释、自定义列（材料、零件编号）的物料清单、中心标记和中心线、尺寸精度、标题栏和图纸。
• **文件：**导出 STEP、STL 和 PDF；自定义属性（零件编号、描述、关联的质量或材料）。
• **检查结果，而非凭空假定：**从模型中测量每个结果（体积、质量、距离、面、草图状态），并根据你的要求报告结果。

要求

• Windows 10 或 11。
• 已安装并获得许可的 SolidWorks 2026，且设置为英语。
• 可运行本地 MCP 服务的 AI 应用。

已在 SolidWorks 2026 SP4.1（英语）和 Windows 11 上测试。

安装

1. 从 Releases 页面下载 FullyDefined-Setup-<version>.exe 并双击运行。

2. 安装程序尚未进行代码签名，因此 Windows 会发出警告。在“Windows protected your PC”提示中，点击 More info，然后点击 Run anyway：

   

3. 勾选要使用的 AI 应用（已在电脑上找到的应用会自动勾选），然后点击 Install。安装需要一两分钟；不会打开任何窗口。

4. 按最后一页的说明重启 AI 应用。

安装程序会完成其余工作：如有需要，会安装 uv 和专用 Python（不会触碰你安装的其他 Python），将服务放在 %LOCALAPPDATA%\solidworks-mcp，连接到你勾选的 AI 应用（包括尚未打开过的应用），并运行安装检查：在 SolidWorks 中构建一个小型测试零件，测量后不保存并关闭，结果必须显示 PASS。最后一页会显示已连接的应用以及需要重启的应用。

除非你勾选相应选项，否则它绝不会替换其他程序添加到 AI 应用中的 solidworks 服务。

**无需使用 .exe：**改为下载 solidworks-mcp-<version>.zip，右键点击该文件，选择 Extract All，然后双击解压文件夹中的 Install SolidWorks MCP（安装过程相同，但会在控制台窗口中运行）。若要通过这种方式替换其他程序的 solidworks 条目，请在解压文件夹中打开命令提示符并运行：

"Install SolidWorks MCP.cmd" -Force

首次使用

启动 SolidWorks 并询问：“连接到 SolidWorks，新建一个零件，在 Front 基准面上绘制直径为 40 mm 的圆，将其拉伸 10 mm，并向我展示结果。”

助手会作为你的操作员：由你决定尺寸、材料和公差。它会在开始时询问一次缺少的信息，然后构建整个零件并报告测量数值。它会使用 solidworks_guide 工具查找操作步骤和注意事项（询问它“显示 SolidWorks 指南主题”即可查看）。

除非你指定其他单位，否则长度均以 mm 为单位。你的设置位于 %APPDATA%\solidworks-mcp\settings.json 中（该文件只保存你更改的内容），例如：

{"groups": {"drawing": false}, "protected_paths": ["C:\\Vault"]}

groups 用于关闭工具组（sketch 20 个工具、features 26 个、sheetmetal 12 个、assembly 20 个、drawing 18 个、 export 3 个；core 21 个工具和指南始终启用）；protected_paths 列出服务绝不会写入的文件夹。更改后请重启 AI 应用。对于从 Microsoft Store 安装的 Claude Desktop，Windows 会将服务的文件存放在 %LOCALAPPDATA%\Packages\Claude_...\LocalCache\Roaming\solidworks-mcp 下；solidworks-mcp doctor 会显示具体位置。

Google：Antigravity 应用、Antigravity CLI 或 Gemini CLI

使用 Google AI Pro 或 Ultra 时，请使用 Antigravity 应用或其 CLI（agy）：自 2026 年 6 月起，Gemini CLI 不再支持这些套餐。Gemini CLI 仍可与付费 Gemini API 密钥搭配使用。应用和 CLI 共用一个 MCP 配置文件 %USERPROFILE%\.gemini\config\mcp_config.json，由安装程序写入；Gemini CLI 使用 %USERPROFILE%\.gemini\settings.json。

Antigravity 应用：

1. 从 antigravity.google/download 安装。
2. 运行 Install SolidWorks MCP（如果你在安装 Antigravity 前已安装过，请再次运行）。摘要中必须显示 “Antigravity: registered”。如果显示“may be too old”，请先更新 Antigravity。
3. 在 Antigravity 中（如果出现提示，请登录 Google 账号）：Settings（左下角）> Customizations > Installed MCP Servers 中会列出 solidworks（如果尚未显示，请点击 Refresh）。

**Antigravity CLI 或 Gemini CLI：**安装它（Gemini CLI：npm install -g @google/gemini-cli，需要 Node.js），运行 Install SolidWorks MCP，然后在新的终端中启动（agy 或 gemini；登录，Gemini CLI 使用 API 密钥），并输入 /mcp list（agy）或 /mcp（gemini）：solidworks 必须显示为已连接。Gemini CLI 只会连接到你信任的文件夹中的服务：如果它询问，请选择信任。

该服务约有 120 个工具。如果应用提示工具或函数声明过多，请关闭部分工具组（参见“首次使用”）并重启应用。

其他 AI 应用

将安装程序显示的代码块添加到应用的 MCP 配置中，然后重启应用。命令始终是 %LOCALAPPDATA%\solidworks-mcp\app\.venv\Scripts\solidworks-mcp.exe，必须写成完整路径：

{ "mcpServers": { "solidworks": { "command": "C:\\Users\\<you>\\AppData\\Local\\solidworks-mcp\\app\\.venv\\Scripts\\solidworks-mcp.exe", "args": [] } } }

应用	代码块的添加位置
Cursor	%USERPROFILE%\.cursor\mcp.json（如果未加载，请添加 "type": "stdio"）。Cursor 只向模型提供约 40 个工具（受其自身限制），少于构建零件所需的数量，因此可能无法使用此服务构建零件；Claude Desktop、Claude Code 和 Antigravity 没有此限制
Windsurf	其 Cascade MCP 设置（“View raw config”）
Cline	MCP Servers > Configure > “Configure MCP Servers”
LM Studio	Program 选项卡 > Install > “Edit mcp.json”
VS Code	mcp.json（“MCP: Open User Configuration”）：在 "servers" 下添加相同条目，并包含 "type": "stdio"
Codex CLI	%USERPROFILE%\.codex\config.toml：使用 command = '<the path>' 配置 [mcp_servers.solidworks]

该服务约有 120 个工具；如果应用使用较少工具时效果更好，请关闭部分工具组（参见“首次使用”）。ChatGPT 无法使用该服务：它只连接远程服务，而此服务必须在运行 SolidWorks 的计算机上运行。

无法实现的功能

• 路径、滑块、锁定到草图和磁性配合，以及布线：SolidWorks 不允许附加程序添加这些功能（布线还需要 SolidWorks Premium）。
• 以倾斜角度创建工程图视图（请改为在模型中保存命名视图）。
• ISO 以外的孔向导孔；沿模型轴以外方向创建线性阵列。
• 焊件：修剪／延伸、端盖、角撑板、旋转型材或移动型材刺穿点（已使用 ISO 管材型材进行测试）。成形工具只能使用其库中的尺寸。
• 工程图中的钣金展开视图或切割清单表格（助手会改为读取切割清单）。
• 重命名零件并让已关闭的装配体随之更新：请改为复制零件（copy_file），然后替换组件。
• SolidWorks 显示对话框时无法操作：请在 SolidWorks 中处理对话框，然后重试。
• 撤销：助手会使用对应的工具反向执行某个步骤（删除特征，或将尺寸改回原值）；已删除的特征无法恢复。
• 强度检查（不包含仿真）。
• 面和边的 ID 仅在几何体发生变化前有效：助手会再次列出它们。

即将推出

更多工具、更多文件格式，以及更快的速度。有想要的功能吗？提交 issue 告诉我们。

更新

运行新版本的安装程序（.exe，或 zip 中的 Install SolidWorks MCP）。你的设置和日志会保留。

卸载

设置 > 应用 > 已安装的应用 > SolidWorks MCP > 卸载。（或者双击 %LOCALAPPDATA%\solidworks-mcp 中的 Uninstall SolidWorks MCP。）卸载程序会从所有已添加该服务的应用中移除该服务、PATH 条目及其文件夹。你的设置和日志会保留；若要一并移除它们，请在命令提示符中运行：

"%LOCALAPPDATA%\solidworks-mcp\Uninstall SolidWorks MCP.cmd" -Purge

uv 会保留。

支持

在 GitHub 上提交 issue（Issues），并使用 bug 报告表单；请附上 solidworks-mcp doctor 的输出。在新的终端中运行 solidworks-mcp doctor：它会检查安装情况（以及 SolidWorks 是否正在运行；它不会启动 SolidWorks），并写入一份报告文件。请将该报告附在 issue 中，并说明你向 AI 提出了什么要求、发生了什么，以及你预期会发生什么。files/TESTING.md 列出了最有帮助的信息。

工具通常会在 SolidWorks 正显示对话框时卡住：请在那里处理对话框。

许可证

MIT License，版权所有 (c) 2026 Adino Myerson。请参阅 LICENSE。

SOLIDWORKS 是 Dassault Systèmes SolidWorks Corporation 的注册商标。本项目与 Dassault Systèmes 或 Anthropic 无关联，也未获得其认可。