适合谁
- 希望使用 Claude Desktop 与 FreeCAD 交互的设计师和工程师
- 希望自动化 CAD 工作流程的开发者和爱好者
F
59FMRS · C
FreeCAD MCP 服务器为 Claude Desktop 提供了丰富的 CAD 控制能力，包括建模、编辑、执行代码和 FEM 分析。它需要用户手动配置 FreeCAD 插件并启动 RPC 服务器。安全性需注意，因为可以执行任意代码。总体而言，这是一个功能强大的工具，适合自动化 CAD 任务。
FreeCAD MCP 是一个模型上下文协议（MCP）服务器，允许你从 Claude Desktop 控制 FreeCAD。它提供了一个 FreeCAD 插件，用于启动 RPC 服务器，并提供了 MCP 工具，用于创建和编辑对象、执行 Python 代码、从零件库插入零件、获取视图截图以及运行有限元分析（使用 CalculiX）。该服务器支持远程连接，并允许通过可选参数控制屏幕截图反馈。
工具能力
create_document
在 FreeCAD 中创建一个新文档。
create_object
在 FreeCAD 中创建一个新对象。
edit_object
编辑 FreeCAD 中的一个对象。
delete_object
删除 FreeCAD 中的一个对象。
execute_code
在 FreeCAD 中执行任意 Python 代码。
insert_part_from_library
从零件库中插入一个零件。
get_view
获取活动视图的截图。
get_objects
获取文档中的所有对象。
get_object
获取文档中的一个对象。
get_parts_list
获取零件库中的零件列表。
run_fem_analysis
对现有的 Fem::FemAnalysis 运行 CalculiX 求解器，并返回摘要结果（最大 von Mises 应力、最大位移、节点数、工作目录）。
安装接入
- 安装 FreeCAD 和 uvx。2. 将 addon/FreeCADMCP 目录复制到 FreeCAD 的插件目录（例如 Linux 上为 ~/.FreeCAD/Mod/）。3. 重启 FreeCAD，从工作台列表中选择“MCP Addon”，然后点击“Start RPC Server”按钮启动 RPC 服务器。4. 在 Claude Desktop 配置文件中添加 MCP 服务器配置（如上所示）。
claude_desktop_config.json
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": [
"freecad-mcp"
]
}
}
}
选型与风险
不适合谁
- 需要实时协作的团队
- 对 CAD 精度要求极高且需要完全控制的环境
- 希望无需安装 FreeCAD 插件即可运行的用户
所需权限
- 需要在本机或远程运行 FreeCAD 和 RPC 服务器
- 需要访问文件系统以读取/写入 FreeCAD 文档和插件
- 允许执行任意 Python 代码，因此需要谨慎使用
风险与副作用
- 恶意提示可能导致执行任意代码，有安全风险
- 远程连接可能暴露未授权访问，需配置允许的 IP 或 CIDR
- 工具可能产生大量截图，增加带宽和存储消耗
常见排障
- 确保 FreeCAD 已安装并正确启动 RPC 服务器
- 检查 Claude Desktop 配置中命令路径是否正确
- 如果远程连接失败，检查主机 IP 和防火墙设置
- 如遇插件问题，确认 addon 目录路径正确并重启 FreeCAD
使用场景
通过自然语言控制 FreeCAD 进行参数化建模
自动化重复性 CAD 任务
从 2D 图纸生成 3D 零件
执行有限元分析并获取结果
支持客户端
Claude Desktop完整支持