freecad-mcp

概述

FreeCAD MCP是一个MCP服务器，它将开源参数化3D建模器FreeCAD与AI助手（如Claude）连接起来。它通过模型上下文协议接口暴露FreeCAD的功能，允许用户使用自然语言命令创建复杂的3D模型和CAD工作流。该服务器包含PartDesign、Part几何创建和视图控制的一系列全面操作，并为Claude Code和Claude Desktop用户提供清晰的安装说明。项目同时维护MCP服务器和一个用户友好的安装程序，支持跨平台操作。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• create_box

  Creates a 3D box object with specified dimensions and fillets

  试试:Create a 50x30x20mm box with 5mm fillets试试:Make a cube with 10mm edge length
• create_cylinder

  Creates a 3D cylinder object with specified radius and height

  试试:Make a cylinder with 25mm radius and 60mm height试试:Create a tall cylinder with 15mm diameter
• add_fillet

  Adds a fillet to an existing object or feature

  试试:Add a 3mm fillet to Pad001试试:Apply 5mm fillet to all edges
• create_hole

  Creates a counterbore hole at a specified position

  试试:Create a 6mm counterbore hole at position (20,10)试试:Add a 10mm diameter hole at center
• create_pattern

  Creates a linear or circular pattern of features

  试试:Make a linear pattern of 5 copies spaced 30mm apart试试:Create a circular pattern with 8 instances
• create_pad

  Creates a PartDesign pad from a sketch with specified length

  试试:Create a PartDesign pad from Sketch001 with 15mm length试试:Add a 20mm pad to Sketch002
• create_mirror

  Creates a mirror of a feature across a specified plane

  试试:Add a mirror of Feature001 across the XZ plane试试:Mirror all selected objects
• take_screenshot

  Takes a screenshot of the current view with specified dimensions

  试试:Take an isometric screenshot at 1200x800试试:Capture a front view
• execute_python

  Executes custom FreeCAD Python scripts for complex operations

  试试:Run a Python script to create a complex shape试试:Execute FreeCAD API code to modify parameters
• zoom

  Adjusts the zoom level of the current view

  试试:Zoom in on the selected object试试:Reset zoom to fit all
• select_object

  Selects an object or feature in the FreeCAD document

  试试:Select Sketch001试试:Choose the cylinder created earlier
• document_management

  Manages FreeCAD document operations like saving and closing

  试试:Save the current document试试:Create a new document试试:Close the current document

说明：Tool names were inferred from the 'Available Operations' section and example prompts in the README. The README doesn't provide explicit tool names but describes categories of operations with example prompts that suggest MCP tool functionali

可对比工具

安装

python -m pip install --user mcp
npm install -g freecad-mcp-setup@latest
npx freecad-mcp-setup setup

pip install mcp
npm install -g freecad-mcp-setup@latest
npx freecad-mcp-setup setup

{
  "mcpServers": {
    "freecad": {
      "command": "python3",
      "args": ["/path/to/.freecad-mcp/working_bridge.py"]
    }
  }
}

FAQ

如何测试FreeCAD MCP是否正常工作？

启动FreeCAD，然后在Claude中输入'Check FreeCAD connection'。您应该会看到FreeCAD工具可用的确认信息。

支持哪些版本的FreeCAD？

FreeCAD MCP需要FreeCAD 1.0或更高版本。Python 3.9+随FreeCAD自动包含。

我可以在其他AI助手上使用FreeCAD MCP吗？

目前，FreeCAD MCP设计为与支持MCP协议的Claude Code和Claude Desktop一起使用。

freecad-mcp 对比