OCCTMCP (Gsdali)

MCP设计创作

提供方 gsdali

设计创作 未标注 无需鉴权 社区 / 第三方

OCCTMCP是一个基于OpenCASCADE的3D CAD模型处理服务,提供50多种工具支持模型的创建、修改、分析和导出,适用于LLM驱动的自动化CAD设计流程。

一句话选型结论

按资料字段整理

OCCTMCP (Gsdali) 属于设计创作类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类设计创作 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 49 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

设计创作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量49暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Swift本地部署3D建模CAD设计自动化处理工程分析模型导出

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 49 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
出图与素材

生成配图、图标与素材。

设计稿处理

读取设计稿、批量改尺寸或导出。

内容生成

按主题生成文案与视觉草稿。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 49 个工具,覆盖面较广,能满足多种调用。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在设计创作场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
OCCTMCP (Gsdali)当前 49 未标注 未标注 无 2026-05-17
Cursor Talk To Figma MCP Da1c7911 40 未标注 未标注 无 2026-05-17
Blender MCP 17 stdio · 本地进程 本地部署 有 2026-05-18
Nova Canvas MCP Server 2 stdio · 本地进程 本地部署 有 2026-05-17
Figma Context MCP 3aaa8d28 未标注 未标注 支持远程部署 无 2026-05-17
kreuzberg 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

设计创作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方gsdali上游标注的维护方 gsdali
分类设计创作本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.9 KB
来自项目仓库与上游目录的原文,未做删改

OCCTMCP

MCP服务器,使LLM能够编写、检查和迭代3D CAD模型 OpenCASCADE 通过 OCCTSwift 家庭。

部分 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`.

### 创作

|工具|目的|
|------|---------|
| `execute_script` |编写并执行任意Swift CAD代码(完整的OCCTSwift API)|
| `get_script` |阅读最新脚本的源代码|
| `get_api_reference` |按类别浏览OCCTSwift API|

### 场景阅读

|工具|目的|
|------|---------|
| `get_scene` |读取当前场景清单(主体、颜色、材质)|
| `export_model` |列出导出的BREP/STEP/STL/OBJ文件路径|
| `compare_versions` |当前场景与N个运行前场景的差异(添加/删除/外观/文件更改)|

### 场景突变

|工具|目的|
|------|---------|
| `remove_body` |从场景中删除实体(manifest+BREP文件)|
| `clear_scene` |擦拭所有物体,可选择保留差异历史记录|
| `rename_body` |更改身体的id|
| `set_appearance` |更新颜色/不透明度/粗糙度/金属/显示名称|

### 内省

|工具|目的|
|------|---------|
| `validate_geometry` |逐体拓扑验证(isValid,错误计数)|
| `compute_metrics` |体积、面积、质心、边界框、主轴|
| `query_topology` |查找面/边/顶点匹配条件,返回稳定的ID|
| `measure_distance` |两个物体之间的最小距离+接触|
| `recognize_features` |通过AAG启发式算法识别口袋和洞|
| `inspect_assembly` |浏览XCAF装配树(STEP/IGES/XBF)|

### 建筑

|工具|目的|
|------|---------|
| `apply_feature` |钻孔/圆角/倒角/拉伸/旋转/螺纹/布尔(FeatureSpec)|
| `transform_body` |平移/旋转/均匀缩放(记录重新映射的身份历史)|
| `boolean_op` |并集/相减/相交/拆分(每个输入历史记录用于重新映射)|
| `mirror_or_pattern` |镜像/线性/圆形图案→ N个新机构|

### 工程分析

|工具|目的|
|------|---------|
| `check_thickness` |薄区域标志的壁厚分析|
| `analyze_clearance` |成对干扰/最小间隙|
| `heal_shape` |修复进口/非水密几何形状;统计数据之前/之后|

### 选择和重新映射

|工具|目的|
|------|---------|
| `select_topology` |拾取面/边/顶点,获得稳定的 `selectionId` |
| `remap_selection` |携带 `selectionId`s跨越同一身体的突变(基于转换/愈合/布尔/应用特征的历史;否则采用质心启发式回退)|
| `find_correspondences` |地图 `selectionId`s从源体到目标体,这是源体的已知变换-- `mirror_or_pattern` 输出是典型情况|
| `select_by_feature` |按特征类型批量挑选(例如所有孔边缘)|
| `list_selections` |检查内存中的选择注册表|
| `clear_selections` |擦除注册表|

### 注释和覆盖

|工具|目的|
|------|---------|
| `add_dimension` |添加线性/角度/径向尺寸;渲染在 `render_preview` |
| `add_scene_primitive` |添加三面体/工作平面/轴/点云/边界框/diffMarker|
| `auto_dimension` |主范围的启发式降维|
| `show_bounding_box` |添加车身的AABB作为覆盖层|
| `diff_overlay` |可视化两个快照之间的差异|
| `remove_scene_annotation` |按id删除维度或图元|
| `list_annotations` |检查sidecar的注释|

### 输入/输出

|工具|目的|
|------|---------|
| `read_brep` |加载a `.brep` 从磁盘到场景|
| `import_file` |多格式导入(STEP/IGES/STL/OBJ);可选XCAF组件|
| `export_scene` |导出到STEP/IGES/BREP/STL/OBJ/glTF/GLB|
| `set_assembly_metadata` |修改XCAF文档或每个组件的元数据|

### 网格和可视化

|工具|目的|
|------|---------|
| `generate_mesh` |细分为三角形+质量指标|
| `simplify_mesh` |QEM网格抽取为.stl/.obj——封装OCCTSwiftMesh的 `Mesh.simplified` (供应商提供的网格优化器)|
| `render_preview` |使用测量标签和基本体覆盖进行单次PNG渲染|
| `generate_drawing` |多视图ISO 128-30 DXF技术图|

### 拓扑图(低级)

|工具|目的|
|------|---------|
| `graph_validate` |验证BREP的拓扑图(原始路径)|
| `graph_compact` |删除未引用的图形节点;写入重建的BREP|
| `graph_dedup` |消除共享曲面/曲线几何图形的重复|
| `graph_ml` |将拓扑+UV/边缘样本导出为ML友好的JSON|
| `feature_recognize` |口袋+孔(原始BREP路径; `recognize_features` 是场景感知包装器)|

## 实现

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

- **迅速** (`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` 它

## 设置

### 快速实施(推荐)```bash
git clone https://github.com/gsdali/OCCTMCP.git
cd OCCTMCP
swift build -c release

在克劳德代码的 .mcp.json:```json
{
"mcpServers": {
"occtmcp": {
"command": "/path/to/OCCTMCP/.build/release/occtmcp-server"
}
}
}


Swift包发布在 Swift包索引.

### 节点实现```bash
git clone https://github.com/gsdali/OCCTMCP.git
cd OCCTMCP
npm install
npm run build

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


## 示例

LLM可以通过编写键入工具来创建CAD模型——大多数日常流程从未涉及 `execute_script`:```text
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:```swift
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.

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
OCCTMCP (Gsdali) 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

OCCTMCP (Gsdali) 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

OCCTMCP (Gsdali) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

OCCTMCP (Gsdali) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

OCCTMCP (Gsdali) 能提供哪些能力?

资料显示约 49 个工具;能力标签包括 Swift、3D建模、自动化处理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。