SuperAPI AI 工具集

freecad-mcp

智能体与模型

查看项目

更新于 10-15 20:08

技能介绍

用途:通过嵌入式 FreeCAD MCP 服务器以结构化工具驱动 FreeCAD,完成模型的创建、检查、编辑、验证、仿真与导出,适合参数化零件、CSG、草图(Sketch)与打印件设计。

主要能力:提供按阶段的工具链,包括 discover_capabilities、inspect_documents、inspect_objects、create_object/create_objects、edit_object/edit_objects、edit_parameters、create_feature/edit_feature、inspect_sketch/edit_sketch、validate_geometry、measure、inspect_topology、export、capture_view、run_fem、import_model、save_document 等;并支持 server/discover、tools/list、tasks/get、tasks/update、tasks/cancel、resources/list、resources/read、subscriptions/listen 等协议能力。

使用方式:先调用 discover_capabilities;GUI 忙时等待、卡住则停止 GUI 调用;编辑既有模型前先 inspect_documents、inspect_objects;按依赖顺序分段建模,每阶段调用后读取名称、状态、边界与实体数并校验,再做下一步;保存可编辑源文件后再做高开销操作;导出只针对最终目标对象。对象引用使用返回的内部名称,不使用显示标签;未指定单位时用毫米。拓扑目标支持整体对象、带符号子元素与声明式查询,选择器使用有界 CadQuery 语法(front=>Z、back=<Z、left=<X、right=>X、top=>Y、bottom=<Y)。批处理创建对象后需读 nameMapping 再建链接;电子表格写入须通过 properties.cells 并确认 cellContentsPersisted: true;run_script 仅在明确不支持的操作时使用,且为任意 Python,具 FreeCAD 用户权限,禁止放入凭据或不可信代码。

验证与限制:交付前要求对象无 Invalid/Error/Touched 状态、validate_geometry 有效、实体数与体积符合设计、边界在容差内;配合件需用 measure 距离与干涉两种模式,或 validate_geometry 的 clearance_min 与 interference_max。超时后先检查状态再重试,避免重复变更;GUI_DISPATCH_STUCK 后仅调用与 GUI 无关的 discover_capabilities。文档未提供具体收费、平台支持范围与性能上限,暂未提供。