OCCTMCP (Gsdali)

OCCTMCP

部分 OCCTSwift生态系统 --请参阅生态系统图，了解此包如何位于内核、视口、网桥和AIS层之上。SemVer从v1.0.0开始稳定。

Swift实现直接在进程内调用OCCT——没有子进程，也没有JSONL编组——并公开了50个类型化的MCP工具，这些工具涵盖了创作、场景读取、变异、内省、构造、分析、I/O、网格、绘图、选择/重映射和维度覆盖。

运作原理

LLM picks a typed tool (boolean_op, transform_body, render_preview, …)
  → OCCTMCP runs the OCCT operation directly via OCCTSwift / Tools / AIS / Mesh
  → Writes BREP/STEP/PNG + manifest.json + annotations.json
  → OCCTSwiftViewport (optional) auto-reloads the 3D model

对于新型几何体，键入的工具无法覆盖，LLM回落到 execute_script：任意Swift代码，带有完整的OCCTSwift API，编译并在进程内运行。

工具

50个工具，组织如下。呼叫 get_api_reference({ category: "mcp_tools" }) 一次性转储每个工具的JSON模式——这对LLM自动发现很有用。大多数流可以回答“体积是多少？”、“使其变红”、“布尔减去这些”、“渲染预览”、“在这两个面之间添加维度”、“导出到STEP”和“绘制此图”，而无需触摸 execute_script.

创作

场景阅读

场景突变

内省

建筑

工程分析

选择和重新映射

注释和覆盖

输入/输出

网格和可视化

拓扑图（低级）

实现

此仓库并排提供了两个实现：

• 迅速 (Sources/, Package.swift)--那个 主要的，重要的 服务器。正在使用以下工具对OCCTSwift/OCCTSwiftMesh/OCCTSwiftTools/OCCTwiftAIS/DrawingComposer进行处理 官方Swift MCP SDK.50个工具。macOS 15+（OCCT.xcframework arm64平台）。
• 节点/TypeScript (src/, dist/)——最初的实施。炮弹发射到 occtkit CLI适用于Swift端的所有内容。36个工具（v0.4之前的曲面；选择/重映射/注释仅限Swift）。如果您无法运行macOS二进制文件，则很有用。

两者都使用stdio MCP，读/写相同的清单格式。

先决条件

• macOS 15+（用于Swift实现）
• Swift 6.1+/Xcode 16+
• 仅适用于Node实现：Node.js 18+，以及 OCCTSwiftScripts 所以 occtkit 开着 $PATH （或 make install 它

设置

快速实施（推荐）

git clone https://github.com/gsdali/OCCTMCP.git
cd OCCTMCP
swift build -c release

在克劳德代码的 .mcp.json:

{
  "mcpServers": {
    "occtmcp": {
      "command": "/path/to/OCCTMCP/.build/release/occtmcp-server"
    }
  }
}

Swift包发布在 Swift包索引.

节点实现

git clone https://github.com/gsdali/OCCTMCP.git
cd OCCTMCP
npm install
npm run build

在 .mcp.json:

{
  "mcpServers": {
    "occtmcp": {
      "command": "node",
      "args": ["/path/to/OCCTMCP/dist/index.js"]
    }
  }
}

示例

LLM可以通过编写键入工具来创建CAD模型——大多数日常流程从未涉及 execute_script:

boolean_op(op: "subtract", aBodyId: "block", bBodyId: "hole", outputBodyId: "drilled")
  → "drilled" body added to the scene
select_topology(bodyId: "drilled", kind: "face", limit: 1)
  → returns selectionId "sel:drilled#face[12]"
add_dimension(kind: "linear", anchors: [...]) ; render_preview()

对于新颖的几何，请进入 execute_script 使用完整的OCCTSwift API：

import OCCTSwift
import ScriptHarness

let ctx = ScriptContext()
let C = ScriptContext.Colors.self

let box = Shape.box(width: 40, height: 30, depth: 20)!
let hole = Shape.cylinder(radius: 5, height: 30)!
    .translated(by: SIMD3(20, -1, 10))!
let result = box.subtracting(hole)!
let filleted = result.filleted(radius: 2.0)!

try ctx.add(filleted, id: "part", color: C.steel, name: "Bracket")
try ctx.emit(description: "Filleted bracket with mounting hole")

API类别

这 get_api_reference 该工具提供以下文档：

• 原语 --盒子、圆柱体、球体、圆锥体、环面、楔形
• 清扫 --拉伸、旋转、扫管、放样、直尺
• 布尔运算 --并集、相减、相交、剖分
• 修改 --圆角、倒角、外壳、偏移、拔模斜度、缺陷
• 变换 --平移、旋转、缩放、镜像
• 电线 --矩形、圆形、多边形、样条曲线、螺旋、偏移
• 曲线2d/3d --直线、圆弧、椭圆、B样条曲线、贝塞尔曲线、插值
• 表面 --平面、圆柱体、圆锥体、球体、挤压、旋转、板
• 分析 --体积、面积、距离、边界、验证
• 进出口 --STL、STEP、IGES、BREP、OBJ、PLY
• mcp_tools --每个MCP工具的JSON模式（便于LLM自动发现）

版本控制

OCCTMCP如下 语义化版本Swift港口到达 v1.0.0 2026年5月9日，与原始Node实现相比，功能完成，加上一层仅限Swift的选择/重映射/注释工具。

发布在GitHub上标记。这 main SPI跟踪的是分支。

许可证

LGPL-2.1或更高版本——与 OCCTSwift.