拓冰网站定制 
FreeCAD MCP 零件库详解一键插入标准件get_parts_list 与 insert 工具全解析【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcpFreeCAD MCP 是连接 AI 助手如 Claude Desktop与 FreeCAD 的 MCPModel Context Protocol服务器其零件库功能允许 AI 通过get_parts_list和insert_part_from_library两个工具一键列出并插入标准件螺栓、螺母、轴承等无需从零建模。本文带你完整理解这套零件库优先的建模工作流。 什么是 FreeCAD MCP 零件库FreeCAD 的官方零件库FreeCAD-library以 Addon 形式安装在 FreeCAD 的用户数据目录下。FreeCAD MCP 的零件库工具直接读取该目录AI 无需写代码即可借用现成的标准件。核心源码位于 addon/FreeCADMCP/rpc_server/parts_library.py只有不到 45 行却实现了完整能力函数作用get_parts_list()递归扫描零件库目录返回所有.FCStd标准件的相对路径列表insert_part_from_library()将指定零件合并进当前活动文档无文档时自动新建实现上还有一道安全防线插入路径会做commonpath校验任何试图用..或绝对路径逃逸出零件库目录的请求都会被直接拒绝可参考 tests/test_parts_library.py 中的越权路径测试用例。 get_parts_list一键列出所有可用标准件get_parts_list是 MCP 端暴露给 AI 的查询工具定义在 src/freecad_mcp/server.pyget_parts_list() - 零件路径列表返回结果是相对于零件库根目录的路径例如screws/bolts/m3x10.FCStd若未安装 parts_library 插件会优雅地返回空列表AI 侧会收到一句友好提示No parts found in the parts library. You must add parts_library addon.而不是抛出异常。这相当于 AI 建模前的货架盘点先看看库里有没有现成的螺栓和轴承。 insert_part_from_library一键把标准件插入设计insert_part_from_library工具定义在 src/freecad_mcp/server.py核心参数参数默认值说明relative_path—零件在库中的相对路径由get_parts_list提供include_screenshottrue是否返回截图中间步骤可设为false节省 tokenview_nameIsometric截图视角如Front、Top、Right执行链路为MCP 服务器 → src/freecad_mcp/operations/core.py 中的insert_part_from_library_operation→ FreeCAD 插件端通过mergeProject将零件文件合并进活动文档成功后自动回传一张等轴测截图让 AI亲眼确认插入结果。⚙️ AI 建模工作流库优先基础体兜底FreeCAD MCP 在系统提示词中内置了明确的建模策略见 src/freecad_mcp/prompt_text.pyAI 会遵循如下顺序查库先用get_parts_list检查可用零件插库件所需零件存在时直接用insert_part_from_library插入兜底建模库中没有时才用create_object创建立方体、圆柱等基础体并用edit_object精修尺寸校验用get_object验证属性用get_view查看效果。这意味着 AI 组装一台机器时会能插螺栓就不画螺栓模型更标准、token 消耗更低。 快速上手安装零件库并连接服务零件库工具依赖 FreeCAD 端 MCP 插件与 RPC 服务就绪安装parts_libraryAddon 与 FreeCAD MCP Addon在 Addon Manager 中搜索安装即可重启 FreeCAD切换到MCP Addon工作台点击Start RPC Server状态栏显示RPC Server started at 127.0.0.1:18757即表示服务就绪在 MCP 客户端如 Claude Desktop配置uvx freecad-mcp后直接向 AI 提问帮我加一颗 M3 螺栓它就会自动完成查库 → 插入 → 截图确认的全过程。❓ 常见问题Qget_parts_list返回空列表怎么办A说明 FreeCAD 未安装 parts_library 插件请在 FreeCAD 的 Addon Manager 中搜索安装后重试。Q插入时报 relative_path escapes the parts libraryA这是安全校验在起作用——路径参数越过了零件库目录请检查传入的路径是否来自get_parts_list的返回值。Q插入后想调整螺栓位置A插入后可用edit_object显式设置位置、缩放与旋转属性确保标准件与主体模型正确配合。总结FreeCAD MCP 的零件库能力把标准件插入简化成两步get_parts_list盘点货架insert_part_from_library一键取件。配合截图反馈与库优先策略AI 建模既高效又贴近工程实际。更多工具一览可查阅 docs/tools.md完整安装步骤见 docs/installation.md。【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FreeCAD MCP 零件库详解：一键插入标准件，get_parts_list 与 insert 工具全解析
FreeCAD MCP 零件库详解一键插入标准件get_parts_list 与 insert 工具全解析【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcpFreeCAD MCP 是连接 AI 助手如 Claude Desktop与 FreeCAD 的 MCPModel Context Protocol服务器其零件库功能允许 AI 通过get_parts_list和insert_part_from_library两个工具一键列出并插入标准件螺栓、螺母、轴承等无需从零建模。本文带你完整理解这套零件库优先的建模工作流。 什么是 FreeCAD MCP 零件库FreeCAD 的官方零件库FreeCAD-library以 Addon 形式安装在 FreeCAD 的用户数据目录下。FreeCAD MCP 的零件库工具直接读取该目录AI 无需写代码即可借用现成的标准件。核心源码位于 addon/FreeCADMCP/rpc_server/parts_library.py只有不到 45 行却实现了完整能力函数作用get_parts_list()递归扫描零件库目录返回所有.FCStd标准件的相对路径列表insert_part_from_library()将指定零件合并进当前活动文档无文档时自动新建实现上还有一道安全防线插入路径会做commonpath校验任何试图用..或绝对路径逃逸出零件库目录的请求都会被直接拒绝可参考 tests/test_parts_library.py 中的越权路径测试用例。 get_parts_list一键列出所有可用标准件get_parts_list是 MCP 端暴露给 AI 的查询工具定义在 src/freecad_mcp/server.pyget_parts_list() - 零件路径列表返回结果是相对于零件库根目录的路径例如screws/bolts/m3x10.FCStd若未安装 parts_library 插件会优雅地返回空列表AI 侧会收到一句友好提示No parts found in the parts library. You must add parts_library addon.而不是抛出异常。这相当于 AI 建模前的货架盘点先看看库里有没有现成的螺栓和轴承。 insert_part_from_library一键把标准件插入设计insert_part_from_library工具定义在 src/freecad_mcp/server.py核心参数参数默认值说明relative_path—零件在库中的相对路径由get_parts_list提供include_screenshottrue是否返回截图中间步骤可设为false节省 tokenview_nameIsometric截图视角如Front、Top、Right执行链路为MCP 服务器 → src/freecad_mcp/operations/core.py 中的insert_part_from_library_operation→ FreeCAD 插件端通过mergeProject将零件文件合并进活动文档成功后自动回传一张等轴测截图让 AI亲眼确认插入结果。⚙️ AI 建模工作流库优先基础体兜底FreeCAD MCP 在系统提示词中内置了明确的建模策略见 src/freecad_mcp/prompt_text.pyAI 会遵循如下顺序查库先用get_parts_list检查可用零件插库件所需零件存在时直接用insert_part_from_library插入兜底建模库中没有时才用create_object创建立方体、圆柱等基础体并用edit_object精修尺寸校验用get_object验证属性用get_view查看效果。这意味着 AI 组装一台机器时会能插螺栓就不画螺栓模型更标准、token 消耗更低。 快速上手安装零件库并连接服务零件库工具依赖 FreeCAD 端 MCP 插件与 RPC 服务就绪安装parts_libraryAddon 与 FreeCAD MCP Addon在 Addon Manager 中搜索安装即可重启 FreeCAD切换到MCP Addon工作台点击Start RPC Server状态栏显示RPC Server started at 127.0.0.1:18757即表示服务就绪在 MCP 客户端如 Claude Desktop配置uvx freecad-mcp后直接向 AI 提问帮我加一颗 M3 螺栓它就会自动完成查库 → 插入 → 截图确认的全过程。❓ 常见问题Qget_parts_list返回空列表怎么办A说明 FreeCAD 未安装 parts_library 插件请在 FreeCAD 的 Addon Manager 中搜索安装后重试。Q插入时报 relative_path escapes the parts libraryA这是安全校验在起作用——路径参数越过了零件库目录请检查传入的路径是否来自get_parts_list的返回值。Q插入后想调整螺栓位置A插入后可用edit_object显式设置位置、缩放与旋转属性确保标准件与主体模型正确配合。总结FreeCAD MCP 的零件库能力把标准件插入简化成两步get_parts_list盘点货架insert_part_from_library一键取件。配合截图反馈与库优先策略AI 建模既高效又贴近工程实际。更多工具一览可查阅 docs/tools.md完整安装步骤见 docs/installation.md。【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考