Cad Mcp Server

CAD MCP 服务

一个用于测量 STEP CAD 文件的 MCP 服务，可供 AI 助手使用：测量整体尺寸和体积、孔和凸台直径、壁厚、间隙、拔模角、横截面，以及两个版本之间的差异。测量由 Open CASCADE 内核根据模型自身的几何数据计算得出。

快速开始

将此服务添加到 MCP 客户端，然后让助手读取 STEP 文件：

{
  "mcpServers": {
    "cad": {
      "command": "npx",
      "args": ["-y", "cad-mcp-server"]
    }
  }
}

可与任何 MCP 客户端搭配使用，包括 Claude Desktop、Cursor 和 VS Code。

示例提示词

• “这个零件的整体尺寸和体积是多少？”
• “找出圆柱面，并列出其直径和轴线。”
• “测量这些面的壁厚，并以毫米为单位报告。”
• “这个孔与最近的壁面之间的最小距离是多少？”
• “测量相对于 +Z 方向的拔模角，并列出拔模角为负的面。”
• “在 X = 40 处剖切这个实体。”
• “版本 A 和版本 B 之间有哪些变化？”

更多示例（包括 DFM 风格的审查提示词）请参阅 docs/EXAMPLE_PROMPTS.md。

工具

工具	返回内容
inspect	边界框尺寸、体积、表面积、实体和装配结构、B-rep 健康状况，以及与版本绑定的引用。
find_entities	面、边、顶点和实体，并支持按曲面类型、半径、轴线和面积筛选。
measure	面间距离、壁厚、拔模角、射线投射、射线网格、点分析、平面剖面和边连续性。
diff	两个 STEP 版本之间的尺寸、体积、面积和拓扑差异，以及解析后的 STEP 元数据。

测量类型包括 distance、thickness、draft、ray、ray_grid、point_analysis、section 和 continuity。长度单位为毫米，角度单位为度。

测量结果可复现：服务会返回实体 ID 和每项测量所依据版本的 SHA-256；如果文件在会话期间发生变化，服务会拒绝过期的 ID。服务报告的是几何数据；零件是否可制造仍需工程判断。

要求

• Node.js 24+
• Windows x64、macOS ARM64（Apple Silicon）或 Linux x64
• STEP 文件，可由 SolidWorks、Fusion 360、Onshape、FreeCAD、CATIA 或其他 CAD 系统导出

常见问题

需要安装 CAD 软件吗？ 不需要。它会直接读取 STEP 文件，因此在没有 CAD 应用或许可证的机器上也能运行。

我的文件会离开本机吗？ 不会。该服务通过 stdio 在本地运行，并根据路径读取文件。它是只读的，绝不会写入你的 CAD 数据。

这与让助手查看截图有什么不同？ 测量由 Open CASCADE 根据模型的 B-rep 几何数据计算得出，因此对同一文件进行相同查询会返回相同数值。每项结果还会附带其来源的实体 ID 和版本。

文档

• 示例提示词
• 架构 — 工具、工作流和限制
• 安全性 — 本地处理以及将 CAD 文件作为敏感输入处理
• 开发 — 源码设置、检查、打包和发布
• 更新日志

许可证

MIT。捆绑的 Open CASCADE sidecar 使用 LGPL-2.1。请参阅 THIRD_PARTY_NOTICES.md。