FurniOx SolidWorks MCP
公共SolidWorks MCP服务器,用于通过本机COM进行日常CAD编辑、模型检查、元数据工作和文件操作。
状态
- 当前版本:
0.1.0-alpha.3 - 发布阶段:alpha
- 当前状态:正在为公共单文档工作流集工作
- 验证说明:当前的公共工具集具有自动覆盖功能,并已在SolidWorks的实际使用中得到验证;仍然需要在其他SolidWorks版本、模板配置和更大的生产装配中进行更广泛的测试
公共表面
公共MCP工具包括:
- 文档生命周期和文档信息
- 配置管理
- 通过程序集浏览
list_assembly_components - 选择助手
- 零件、装配和图纸分析工具
- 自定义属性和摘要信息工具
- 单文档文档治理工具,包括重命名助手和孤立文件检测
- 单文档交叉引用和方程引用扫描和修复
- 草图创建、编辑、参数化、检查和专用草图工具
- 为拉伸、旋转、圆角和壳创建特征
- 导出到STEP、IGES、STL、PDF和DXF
- 排序和文件夹检查助手
公共资源包括:
solidworks://connection/statussolidworks://document/activesolidworks://metrics/performancesolidworks://project/about
不在公共场合
公共分配不包括:
- 批分析、批属性、批引用和批治理工作流
- 桥接/插件集成、诊断和进程内加速层
- SWOOD特定的工具和依赖关系
- 私有文档管理器加速路径
安装
选项1:打包的Windows可执行文件
对于非技术用户来说,一旦发布资产,这是最简单的方法。
当前alpha包装说明:
- 包格式:Windows自包含的单个文件
.exe在zip存档中 - 运行时模型:自包含
- 额外的先决条件:没有单独的。NET运行时安装是必需的
安装步骤:
- 从下载最新的Windows发行版软件包 发布.
- 将存档解压缩到本地文件夹。
- 保持
FurniOx.SolidWorks.MCP.exe,appsettings.json,以及appsettings.local.example.json一起。 - 复制
.mcp.exe.example.json进入MCP客户端配置并替换 `` 使用提取的可执行路径。
要自行构建打包的Windows版本,请执行以下操作:
pwsh ./scripts/publish-public-release.ps1该脚本从公共源代码树中打包,发布一个自包含的单文件Windows构建,并在下创建一个zip存档 out/releases/.
选项2:从源代码构建
如果要检查或修改代码库,请使用此路径。
需求
- Windows 10/11
- .NET SDK
10.0.100或兼容的小前滚 - 安装SolidWorks用于实际服务器使用和手动集成测试
构建
dotnet restore
dotnet build FurniOxSolidWorks-MCP.sln从源设置MCP客户端
MCP客户端配置示例见 .mcp.example.json.更换 `` 使用您当地的结账路径。
测试
单元和包装器测试在没有SolidWorks的情况下运行。COM支持的集成测试是可选的,仅在以下情况下执行 SOLIDWORKS_INTEGRATION_TESTS=1.
dotnet test FurniOxSolidWorks-MCP.sln要手动运行COM支持的集成测试,请执行以下操作:
$env:SOLIDWORKS_INTEGRATION_TESTS = '1'
dotnet test tests/FurniOx.SolidWorks.Integration.Tests要验证公共边界,请执行以下操作:
pwsh ./scripts/check-public-boundary.ps1从源运行
dotnet run --project src/FurniOx.SolidWorks.MCP服务器使用stdio传输,旨在由MCP客户端启动。
配置
运行时设置已上线 src/FurniOx.SolidWorks.MCP/appsettings.json 在...之下 SolidWorks.
重要设置:
ProgIdVersion:针对特定版本的COM ProgID的可选SolidWorks主要修订提示TemplateVersion:可选安装年份仅用于传统模板路径回退PartTemplatePath,AssemblyTemplatePath,DrawingTemplatePath:当您不想依赖SolidWorks用户首选项时,请明确模板路径ComParameterLimit:超大工具载荷到达COM之前的护栏CircuitBreaker:故障阈值和重置超时PublicProfile:Contact:GitHub和LinkedIn链接solidworks://project/about
文档创建的模板解析顺序:
- 配置中的显式模板路径
- 传统路径源自
TemplateVersion - SolidWorks用户首选项默认模板
建筑
公共回购遵循一致的结构:
SolidWorks2023Adapter是公共路由和组合根- 公共运营目录
src/FurniOx.SolidWorks.Core/Operations/ - 大型域使用精简协调器和集中的子处理程序
- MCP工具类按能力系列划分
- 公共工具界面有意避免使用内部桥接、批处理、插件、诊断和SWOOD工具
项目布局
src/
FurniOx.SolidWorks.Shared/ Public shared models and configuration
FurniOx.SolidWorks.Core/ Public COM adapter, operations, routing, and helpers
FurniOx.SolidWorks.MCP/ Public MCP host, tools, and resources
tests/
FurniOx.SolidWorks.Core.Tests/
FurniOx.SolidWorks.Tools.Tests/
FurniOx.SolidWorks.Integration.Tests/开放核心模型
此存储库是公共MCP表面。
内部/私有扩展是单独维护的,不需要构建或使用公共服务器。公共边界由解决方案布局、项目引用和 scripts/check-public-boundary.ps1.
联系
推荐的公众联系渠道:
- GitHub组织或公共存储库
- 用于直接外联的LinkedIn个人资料
填充这些 SolidWorks:PublicProfile:Contact 因此,README工作流和MCP solidworks://project/about 资源指向相同的位置。
