FreeCAD MCP

FreeCAD MCP

site icon
2025.04.16 87
PythonCAD 设计自动化工具开发效率
FreeCAD MCP 是一个用于从 Claude Desktop 控制 FreeCAD 的工具。它允许用户通过远程过程调用(RPC)服务器与 FreeCAD 交互,执行各种设计任务,如创建文档、编辑对象、执行代码等。
View on GitHub

Overview

基本能力

产品定位

FreeCAD MCP 是一个用于从 Claude Desktop 控制 FreeCAD 的工具,主要用于 CAD 设计和自动化任务。

核心功能

  • 创建和编辑 FreeCAD 文档和对象
  • 执行任意 Python 代码
  • 从零件库插入零件
  • 获取视图截图和对象列表

适用场景

  • CAD 设计自动化
  • 从 2D 图纸创建 3D 模型
  • 快速原型设计

工具列表

  • 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: 获取零件库中的零件列表

使用教程

使用依赖

  • 已安装 FreeCAD
  • 已安装 Git

安装教程

  1. 克隆仓库:
git clone https://github.com/neka-nat/freecad-mcp.git
  1. 将插件复制到 FreeCAD 的插件目录:
cd freecad-mcp
cp -r addon/FreeCADMCP ~/.FreeCAD/Mod/
  1. 重启 FreeCAD
  2. 从工作台列表中选择 "MCP Addon"
  3. 在 "FreeCAD MCP" 工具栏中点击 "Start RPC Server" 启动 RPC 服务器

调试方式

  1. 确保 RPC 服务器已启动
  2. 检查 Claude Desktop 配置是否正确
  3. 尝试执行简单的命令如 create_document 测试连接

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。