Ottogeo — CAD MCP Server

Ottogeo — CAD MCP 服务

让任何 AI 助手都能测量真实的 CAD 几何形状。该服务使用 Open CASCADE 内核打开 STEP 文件，并回答工程师实际会提出的问题——整体尺寸和体积、孔和凸台的直径、壁厚、间隙、拔模角、截面，以及两个版本之间的变化——所有数值都根据模型自身的 B-rep 计算得出，而非根据截图估算。

快速开始

将该服务添加到 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	面间距离、壁厚、拔模角、射线投射、射线网格、点分析、平面剖切和边连续性。
describe_pmi	声明的尺寸（标称值及偏差或边界）、几何公差（值、公差带、材料修饰符、基准）和基准，并分别列出其适用的实体 ID。
diff	两个 STEP 版本之间的尺寸、体积、面积和拓扑差异、声明的 PMI 数量，以及解析后的 STEP 元数据。

测量类型包括 distance、thickness、draft、ray、ray_grid、 point_analysis、section 和 continuity。长度使用文件中声明的单位返回， 并在每个结果中标明，因此英制模型会继续使用英寸，无需手动换算。角度以度为单位。

为什么这些数值可信

• 由 Open CASCADE 计算，而非猜测。 每次查询同一文件，都会返回相同的数值。
• 绑定修订版本并可自我验证。 每个结果都会附带实体 ID 和其来源版本的 SHA-256；如果文件在会话期间发生变化，过时的 ID 会被拒绝，因此答案绝不会关联到错误的几何体。
• 读取模型自身的标注。 describe_pmi 会报告文件中声明的尺寸、几何公差和基准，并将每项内容绑定到其适用的实体，以便根据几何体检查声明的要求。
• 本地运行，保护隐私。 它通过 stdio 运行，并按路径读取文件。它是只读的，绝不会上传或写入你的 CAD 数据。

要求

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

常见问题

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

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

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

开发

源代码设置、检查、打包和发布说明见 docs/DEVELOPMENT.md。 服务面向 Windows x64、macOS ARM64 和 Linux x64，并基于固定的 OCCT 修订版本构建其原生 sidecar。

打包

npm pack 会先进行构建，并包含编译后的服务、原生 sidecar、本 README 和第三方声明。测试和源映射不会包含在内。安装该 tarball，以便使用兼容的 MCP 客户端检查 cad-mcp-server 可执行文件。

文档

• 示例提示词
• 架构 — 工具、工作流和限制
• 安全 — 本地处理，以及将 CAD 文件视为敏感输入
• 更新日志

许可证

MIT。第三方许可证：THIRD_PARTY_NOTICES.md。