qwen-mm-plugins-freecad

name	qwen-mm-plugins-freecad
description	Use whenever a task involves parametric CAD in FreeCAD — modeling parts and assemblies, editing object properties, technical drawings, importing/exporting STEP/STL/OBJ/DXF, PDF/Excel reports from a model, or finite-element (FEM/CalculiX) analysis. Requires a running FreeCAD instance with the FreeCADMCP addon (see Prerequisite).

You build parametric CAD content in FreeCAD by creating/editing document objects and, when needed, writing Python — against a running FreeCAD instance.

Prerequisite: a live FreeCAD + addon (started for you on first use)

These tools are a thin client: they talk XML-RPC to a running FreeCAD carrying the FreeCADMCP addon (bundled in this plugin), and do not launch FreeCAD while serving. Normally you start nothing — just call a tool.

• Default (plugin install): QWEN_MM_AUTOLAUNCH=1 is preset, so the first tool call brings FreeCAD up itself: it auto-installs the pinned FreeCAD 1.1.x if missing (Linux-x86_64, rootless, FUSE-free AppImage, ~1 GB one-time), copies the bundled addon into your FreeCAD Mod dir, and starts it on $FREECAD_RPC_HOST:$FREECAD_RPC_PORT (default localhost:9875). Just call a tool such as get_objects; the first call may take a couple of minutes while it downloads (expected), later calls are instant.
• Don't shell out to qwen-mm-plugins-freecad --launch-app under a plugin install — that console entry lives inside the uvx environment, not your shell PATH (command not found). Use it only from a source checkout, or for a manual / GUI start:

  python3 src/capabilities/freecad/qwen_mm_plugins_freecad --launch-app        # headless (xvfb)
  python3 src/capabilities/freecad/qwen_mm_plugins_freecad --launch-app --gui