关于 FreeCAD MCP
FreeCAD MCP 是一个 MCP 服务,可让 Claude Desktop 等 MCP 客户端控制 FreeCAD 进行建模。它包含运行在 FreeCAD 内的插件和通过 uvx 启动的 MCP 服务器,适合需要通过自然语言操作 CAD 的用户。
主要功能
- 01创建与编辑 FreeCAD 模型
- 02运行 Python 脚本
- 03检查文档内容
- 04执行 FEM 有限元分析
适用场景
- 01在 Claude Desktop 中通过对话生成零件模型
- 02根据 2D 图纸辅助建模
- 03对模型进行 FEM 分析
MCP 相关
该项目是 MCP 服务,由 uvx 启动的服务器连接运行在 FreeCAD 内的 RPC 插件,并向 Claude Desktop 等 MCP 客户端提供 FreeCAD 操作能力。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
FreeCAD MCP
通过 Claude Desktop 和其他 MCP 客户端控制 FreeCAD。创建和编辑模型、 运行 Python 脚本、检查文档并运行 FEM 分析。
演示
设计一个法兰:

查看更多演示和示例,了解玩具车、根据 2D 图纸建模以及 Agent 集成。
快速开始
你需要 FreeCAD 和 uv / uvx。 FreeCAD MCP 包含两个组件:在 FreeCAD 内运行的插件,以及由客户端启动的 MCP 服务。
1. 安装并启动 FreeCAD 插件
git clone https://github.com/neka-nat/freecad-mcp.git
cd freecad-mcp
将 addon/FreeCADMCP 复制到你的 FreeCAD 插件目录,
然后重启 FreeCAD。选择 MCP Addon 工作台,并点击 FreeCAD MCP 工具栏中的
Start RPC Server。
查看安装指南,了解特定平台的命令和截图。
2. 连接 Claude Desktop
将以下条目添加到 claude_desktop_config.json:
{
"mcpServers": {
"freecad": {
"command": "uvx",
"args": ["freecad-mcp"]
}
}
}
重启 Claude Desktop 以加载配置,保持 FreeCAD 打开并运行其 RPC
服务,然后让 Claude 创建模型。连接默认使用 localhost。
文档
| 指南 | 内容 |
|---|---|
| 安装 | 插件目录、设置截图、从源代码运行 |
| 配置 | 自动启动、文本反馈、远程连接 |
| 工具 | 可用工具、截图、FEM 分析 |
| 代码执行 | GUI 执行、后台作业、无头脚本、超时故障排查 |
| 演示和示例 | 设计演示、FEM 示例、ADK 和 LangChain 集成 |
贡献者
由 contrib.rocks 制作。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
