如何 10 分钟搭好 FreeCAD MCP从安装到连接 Claude Desktop 的完整新手指南【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp想让 AI 帮你直接画出 3D 模型吗FreeCAD MCP 是 FreeCAD 的 MCPModel Context Protocol模型上下文协议服务器它可以让你用 Claude Desktop 等 AI 客户端通过自然语言直接操控 FreeCAD——创建零件、修改属性、运行 Python 脚本甚至跑 FEM 结构分析。本文带你走完 FreeCAD MCP 新手安装的完整流程装插件、启动 RPC 服务器、配置并连接 Claude Desktop约 10 分钟即可完成首次对话建模。什么是 FreeCAD MCPAI 如何操控 FreeCADFreeCAD MCP 由两部分组成理解这一点后面就不会迷路组件位置作用FreeCAD 插件Addon运行在 FreeCAD 内部启动 RPC 服务器默认127.0.0.1:9875执行实际的建模操作MCP 服务器freecad-mcp由 AI 客户端自动拉起把 Claude 的工具调用翻译成 FreeCAD 能执行的请求装好后你对 Claude 说一句话FreeCAD 里就会真的建出模型来更多演示玩具车、从 2D 图纸建模可以在 docs/examples.md 中查看。安装前准备FreeCAD MCP 的环境要求✅ 按清单检查三项避免装到一半卡住FreeCAD1.x 版本正常安装并可用uv / uvxPython 包管理工具用于由 AI 客户端自动拉起 MCP 服务器Python 3.12MCP 服务器要求 3.12 或更高版本。⚠️ 新手最容易踩的坑插件跑在 FreeCAD 自带的 Python 里MCP 服务器跑在uv提供的外部 Python 里两套环境互相独立不要把freecad-mcp包装进 FreeCAD 的 Python 里。安装 FreeCAD MCP 插件克隆仓库并复制到 Mod 目录第一步克隆仓库git clone https://gitcode.com/gh_mirrors/fr/freecad-mcp cd freecad-mcp第二步把 addon/FreeCADMCP/ 目录复制到你系统的 FreeCAD 插件目录Mod 目录最终结构必须是Mod/FreeCADMCP目录里能直接看到InitGui.py不要多套一层。各平台目录速查系统插件Mod目录WindowsFreeCAD 1.1%APPDATA%\FreeCAD\v1-1\Mod\macOSFreeCAD 1.1~/Library/Application Support/FreeCAD/v1-1/Mod/LinuxUbuntu~/.FreeCAD/Mod/以 Ubuntu 为例mkdir -p ~/.FreeCAD/Mod/ cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/其他发行版Debian、Arch、Flatpak、Snap 等的完整命令见 docs/installation.md。也可以打开 FreeCAD 的View → Panels → Python console执行print(os.path.join(FreeCAD.getUserAppDataDir(), Mod))直接打印出你机器的插件目录最稳妥。复制完成后重启 FreeCAD在工作台下拉列表中选择MCP Addon 如果重启后找不到 MCP Addon 工作台多半是复制时多套了一层目录打开View → Panels → Report view查看插件导入报错即可定位。启动 RPC 服务器确认端口监听成功切换到 MCP Addon 工作台后点击FreeCAD MCP工具栏里的Start RPC Server按钮。启动结果会直接显示在状态栏成功时会包含监听地址、端口和 FreeCAD 进程号例如127.0.0.1:9875 懒人技巧在FreeCAD MCP菜单中勾选Auto-Start Server以后每次打开 FreeCAD 都会自动启动 RPC 服务器配置保存在freecad_mcp_settings.json中详见 docs/configuration.md。连接 Claude DesktopFreeCAD MCP 客户端配置打开 Claude Desktop 的配置文件claude_desktop_config.json加入下面这段核心只有三行{ mcpServers: { freecad: { command: uvx, args: [freecad-mcp] } } }然后重启 Claude Desktop。此时保持 FreeCAD 打开且 RPC 服务器处于运行状态——默认连接走localhost无需任何额外设置。想在局域网内远程控制另一台机器上的 FreeCAD见 docs/configuration.md 的远程连接与安全令牌配置。首次使用 FreeCAD MCP一句话让 AI 建模先做个 30 秒小测试让 Claude 新建一个文档创建一个 Part::Box。回到 FreeCAD方框出现了、list_documents和get_objects都能查到它就代表全链路打通了 之后就可以放开玩比如设计一个带四个螺栓孔的法兰、把圆角改成 R5。工具集覆盖了文档/对象的增删改查、在 GUI 线程或后台执行 Python、截图查看视图、插入标准零件库零件以及运行 CalculiX 求解器的 FEM 分析完整清单见 docs/tools.md更惊艳的是从 2D 图纸建模。给它一张标注好尺寸的工程图Claude 会读取图纸上的尺寸与圆角直接在 FreeCAD 里建模完成故障排查速查FreeCAD MCP 连不上怎么办症状原因与解法状态栏报address already in use9875 端口被占用结束占用进程后重新点 Start RPC Server启动失败会自动释放监听可直接重试连接后工具回复带版本不匹配警告插件与freecad-mcp包版本不同步按提示更新对应一侧并重启 FreeCADWindows 上客户端报EFTYPE/uv_spawn把配置命令数组改为[cmd, /c, freecad-mcp]即可绕过怀疑不是 FreeCAD 在监听 9875用外部 Python 3.12 调ping()返回True才是 FreeCAD 的 XML-RPC 服务器端口被占用时的状态栏提示长这样更完整的超时、后台任务与无头脚本排查方法见 docs/execution.md。进阶配置与延伸阅读安装完成只是开始这几个选项会让使用体验明显提升Auto-Start Server免手动点按钮docs/configuration.md--only-text-feedback关闭工具反馈里的截图省 token远程连接 认证令牌 / SSH 隧道跨机器控制 FreeCAD 的安全姿势FEM 分析示例examples/cantilever_fem.py 演示了从建模到 CalculiX 求解的完整流程项目核心源码位于 src/freecad_mcp/插件本体位于 addon/FreeCADMCP/想深入了解 RPC 派发、健康检查等机制可以直接翻阅。现在打开 Claude Desktop 说一句帮我建一个支架享受 AI 替你搬砖的快乐吧 【免费下载链接】freecad-mcpFreeCAD MCP(Model Context Protocol) server项目地址: https://gitcode.com/gh_mirrors/fr/freecad-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考