FreeCAD相关MCP项目（内容未获取）

HowCCC/freecad-mcp

通过模型上下文协议 (Model Context Protocol, MCP) 把 AI 助手接入 FreeCAD，覆盖建模、装配、机加工工作流与曲面编辑。几何运算、装配求解与刀路生成均使用 FreeCAD 的原生 API（应用程序编程接口）。

功能与模块能力

核心建模 · 152 个工具
文档与对象、零件设计 (PartDesign)、草图 (Draft)、电子表格、导入/导出、视图与截图、宏、Python 执行与模型检查。

装配 · 67 个工具
13 种关节类型、原生求解与诊断、刚性/柔性实例与嵌套实例、运动仿真、物料清单 (BOM) / CSV（逗号分隔值文件）、爆炸图与 ASMT 导出。

CAM（计算机辅助制造）/ Path（路径） · 69 个工具
17 个加工操作族、10 种修边类型、多刀具、坯料与工件设置、模型替换、路径统计、体素 (voxel) 坯料去除、LinuxCNC 后处理与设置报告。

曲面 · 54 个工具
B 样条 (BSpline) / 贝塞尔 (Bezier) 几何、控制点与权重、原生曲面特征、裁剪与投影、曲率与采样连续性、保留裁剪的 NURBS（非均匀有理 B 样条）编辑，以及将编辑后的面缝合回实体。

MCP 集成

stdio / HTTP 传输；socket、XML-RPC 与嵌入式 FreeCAD 适配器；发现资源与建模提示。

共 342 个工具。本清单并不意味着完整的工作台覆盖。请参阅覆盖报告以及详细功能与许可指南（中文）。

快速上手

需要 Python ≥ 3.11、FreeCAD 与一个在 FreeCAD 内运行的兼容桥接器。请单独安装并启动 Robust MCP Bridge 工作台，使用 socket 端口。FreeCAD 与桥接器工作台需分别安装。

在项目目录下安装并检查连接：

python3 -m pip install

freecad-nexus --mode socket --host 127.0.0.1 --port 9876 --check

将此配置添加到你的 MCP 客户端。如果客户端找不到可执行文件，请使用其绝对路径作为 command：

{"mcpServers": {"freecad-nexus": {"command": "freecad-nexus", "args": ["--mode", "socket", "--host", "127.0.0.1", "--port", "9876"]}}}

对于 XML-RPC，使用 --mode xmlrpc --port 9875。现有的 FREECAD_* 环境变量仍然受支持；运行 freecad-nexus --help 查看可用选项。桥接器可以执行 Python，因此请将其连接到受信的本地 FreeCAD 会话。

工业示例

三个示例均通过 MCP stdio → socket 桥接器 → 原生 FreeCAD 生成，共 62 次成功调用，覆盖 28 个工具。脚本负责创建基础几何；专用 MCP 工具处理关节、运动、BOM、CAM 与 NURBS 编辑。每个 CAD 文件均经过重新保存、重新打开，并校验实体有效性与体积保持。

旋转检测执行器

一个简化的检测头由固定导轨框架与一个圆柱关节（沿平移与旋转方向驱动）组成。仿真验证 60 mm 行程与 90° 旋转，然后生成 BOM 与爆炸式维修视图。

FreeCAD 模型　STEP　爆炸图　BOM

铝制安装板

一块 120 × 80 × 12 mm 的板材带两个凹坑与四个间隙孔。专用 CAM 工具配置毛坯余量、一把 Ø6 mm 立铣刀与一把 Ø6.6 mm 钻头，然后生成凹坑加工、钻孔与轮廓加工操作、路径统计、一个 LinuxCNC 程序与一份设置报告。图片显示该零件；原生刀路保存于 CAD 文件中的 PlateJob/Operations 之下。

FreeCAD 模型　STEP　LinuxCNC 程序　设置报告

NURBS 传感器外壳

一个空心的 120 × 80 mm 外壳保留了外缘、连接器端口与通风槽，四个内部控制点将其顶面抬起。编辑后的面片被缝合回一个有效实体，验证体积增加 28,800 mm³，中心高度为 30.75 mm。安装凸台与一块独立的底板共同构成本例；浅色等参线（译注：等参线即 isocurve，NURBS 曲面上 U/V 方向参数恒定的网格线，常用于直观显示曲面形状与光滑度）显示弯曲的顶部。

FreeCAD 模型　STEP　测量结果

重新生成示例

选择一个空的输出目录：

python3 examples/run_industrial_cases.py \
  --freecad-bin /Applications/FreeCAD.app/Contents/MacOS/FreeCAD \
  --bridge-source ../freecad-addon-robust-mcp-server/freecad/RobustMCPBridge \
  --output /tmp/freecad-nexus-examples

请参阅生成脚本、MCP 调用记录与扩展示例说明（中文）。这些示例演示了工程工作流；执行器支撑与干涉、加工夹具与机床参数仍需工程师审核。外壳的内部顶面仍保持平面，因此其壁厚会发生变化。