clo3d-mcp: Skill for Claude Code

Building garments from лекала in CLO via MCP

Prerequisites

1. CLO must be running with the MCP listener up: clo_ping → "CLO listener is up." If not: CLO menu Settings → Plug-in → MCP Listener (start / stop) — the first click auto-starts the listener on 127.0.0.1:5005. Plugin debug log: C:\Users\Public\Documents\CLO\clo_mcp_plugin.log.
2. Commands run on CLO's main thread. During simulate / import_project / render_image the CLO window stops responding — this is normal, NOT a crash. Warn the user not to close the window; Windows will offer to kill it (AppHangB1).

CRITICAL: checkpoint before sewing

There is no remove_seam and no undo over MCP — a wrong seam is permanent for the session. Before any sewing experiment, save a checkpoint:

export_zprj  →  e.g. C:\projects\mcps\clo3d\out\checkpoint-before-sew.zprj

If sewing goes wrong, import_project the checkpoint back.

Pipeline

1. Import (if starting from DXF)

import_project imports AAMA/ASTM DXF (e.g. exported from Grafis v11 with Collating on). It keeps the avatar and replaces existing garment patterns. Pieces land flat, un-arranged, un-sewn.

2. Inventory the pieces

• pattern_count, then pattern_info(i) for each — returns only bbox, id, name (NO outline geometry).
• Names from Russian DXFs arrive cp1251-mojibaked (ïåðåä = перед). Decode: s.encode('latin1').decode('cp1251'). Typical names: перед=front, спинка=back, рукав=sleeve, манжета=cuff, стойка=collar stand, воротник=collar, планка=placket, кокетка=yoke, бейка=binding.
• Pieces lying flat on the 2D table have z≈const (e.g. 200) and depth≈0 in their bbox; arranged pieces have real 3D positions.

3. Probe outlines

Run python scripts/probe_outlines.py — dumps every outline line length for all patterns in seconds by talking to the listener directly (much faster than per-line MCP calls). Gotcha: out-of-range line_length returns 0, not an error — the real line count is the index of the first 0.