FreeCAD MCP Server

社区

通过 Claude Desktop 控制 FreeCAD 的 MCP 服务器。

分类: 开发工具第 133 / 438
Stars: ★ 2.8k 非常热门
传输方式: stdio（本地进程）
运行环境: Python · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 4 天前
工具数: 11

59FMRS · C

FreeCAD MCP 服务器为 Claude Desktop 提供了丰富的 CAD 控制能力，包括建模、编辑、执行代码和 FEM 分析。它需要用户手动配置 FreeCAD 插件并启动 RPC 服务器。安全性需注意，因为可以执行任意代码。总体而言，这是一个功能强大的工具，适合自动化 CAD 任务。

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

14/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 服务器定义了一系列工具，包括 execute_code 等，但未提供测试或 CI 证据。无法确认工具的实际行为，但 README 描述了使用示例，happy path 看似可行。扣除：缺少测试和 CI，错误处理细节未明。
安全与权限 12/20: 存在 execute_code 和远程连接功能，且远程连接有 IP 白名单保护，但默认仅本地监听。未发现明显的恶意代码或凭据泄露。扣除：execute_code 具有高权限，可能执行任意代码，但用户需明确使用；远程连接默认关闭，有 IP 过滤。
维护活跃度 14/20: 仓库活跃，有 1680 stars 和 35 个开放 issues，近期有提交（依据 README 中远程连接功能）。但未提供版本发布或安全响应渠道的信息。扣除：缺乏版本发布和依赖更新记录。
文档质量 13/20: README 提供了详细的安装、配置和工具说明，包括远程连接和截图参数。但缺少故障排除和限制披露。扣除：缺少故障排除章节和成本/限制信息。
安装易用性 12/20: 安装步骤清晰，支持多种平台，并提供了 Claude Desktop 配置示例。但需要依赖 uvx 和 FreeCAD 的额外设置。扣除：需要手动安装 addon 和启动 RPC 服务器，步骤较多。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

希望使用 Claude Desktop 与 FreeCAD 交互的设计师和工程师
希望自动化 CAD 工作流程的开发者和爱好者

不适合谁

需要实时协作的团队
对 CAD 精度要求极高且需要完全控制的环境
希望无需安装 FreeCAD 插件即可运行的用户

所需权限

需要在本机或远程运行 FreeCAD 和 RPC 服务器
需要访问文件系统以读取/写入 FreeCAD 文档和插件
允许执行任意 Python 代码，因此需要谨慎使用

风险与副作用

恶意提示可能导致执行任意代码，有安全风险
远程连接可能暴露未授权访问，需配置允许的 IP 或 CIDR
工具可能产生大量截图，增加带宽和存储消耗

安装接入

准备工作

运行环境：Python · 预编译二进制

安装 FreeCAD 和 uvx。
将 addon/FreeCADMCP 目录复制到 FreeCAD 的插件目录（例如 Linux 上为 ~/.FreeCAD/Mod/）。
重启 FreeCAD，从工作台列表中选择“MCP Addon”，然后点击“Start RPC Server”按钮启动 RPC 服务器。
在 Claude Desktop 配置文件中添加 MCP 服务器配置（如上所示）。

claude_desktop_config.json

{
  "mcpServers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "freecad": {
      "command": "uvx",
      "args": [
        "freecad-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add freecad -- uvx freecad-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在Claude Desktop的工具列表中应出现freecad服务器的11个工具（如 create_document、get_view、run_fem_analysis）；也可启动FreeCAD中MCP Addon工作台的RPC服务器后，让客户端调用get_objects确认连接。

常见排障

确保 FreeCAD 已安装并正确启动 RPC 服务器
检查 Claude Desktop 配置中命令路径是否正确
如果远程连接失败，检查主机 IP 和防火墙设置
如遇插件问题，确认 addon 目录路径正确并重启 FreeCAD

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我在FreeCAD里设计一个法兰零件
从这张2D图纸建模一个三维零件
显示当前视口的截图
对现有的Fem::FemAnalysis运行CalculiX有限元分析并给出最大应力和位移

工具能力 11

create_document 写入

在 FreeCAD 中创建一个新文档。

create_object 写入

在 FreeCAD 中创建一个新对象。

edit_object 写入

编辑 FreeCAD 中的一个对象。

delete_object 破坏性

删除 FreeCAD 中的一个对象。

execute_code 写入

在 FreeCAD 中执行任意 Python 代码。

insert_part_from_library 写入

从零件库中插入一个零件。

get_view 只读

获取活动视图的截图。

get_objects 只读

获取文档中的所有对象。

展开其余 3 个工具

get_object 只读

获取文档中的一个对象。

get_parts_list 只读

获取零件库中的零件列表。

run_fem_analysis 写入

对现有的 Fem::FemAnalysis 运行 CalculiX 求解器，并返回摘要结果（最大 von Mises 应力、最大位移、节点数、工作目录）。

使用场景

通过自然语言控制 FreeCAD 进行参数化建模

自动化重复性 CAD 任务

从 2D 图纸生成 3D 零件

执行有限元分析并获取结果

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

FreeCAD MCP 是一个模型上下文协议（MCP）服务器，允许你从 Claude Desktop 控制 FreeCAD。它提供了一个 FreeCAD 插件，用于启动 RPC 服务器，并提供了 MCP 工具，用于创建和编辑对象、执行 Python 代码、从零件库插入零件、获取视图截图以及运行有限元分析（使用 CalculiX）。该服务器支持远程连接，并允许通过可选参数控制屏幕截图反馈。