garment-cad-mcp

Agent-facing garment CAD control plane built around pinned Valentina and GarmentCode sources.

It provides two local stdio MCP servers, a shared Python SDK, preview/commit transactions, append-only revisions, a native GarmentCode document, and a serial AutoDL GPU worker API. Public geometry uses millimetres; the native GarmentCode host converts to centimetres at its boundary.

from garmentcad import GarmentSDK

cad = GarmentSDK("./projects/sample")
preview = cad.commands.pattern_along_line(
    alias="front.armhole.guide",
    first_point={"alias": "front.shoulder"},
    second_point={"alias": "front.underarm"},
    length_mm=35,
)
# Inspect preview.summary, then commit explicitly:
# garmentcad commit <preview.preview_token> --path ./projects/sample

Valentina, Tape, and Puzzle recipes use the schema-generated typed atomic surface. They create all 2D geometry; GarmentCode only receives a read-only projection for sewing and 3D placement. The same contracts are embedded in lazily loaded MCP tool schemas:

assembly_preview = cad.sync_assembly_from_pattern(bindings={"interfaces": [], "stitches": []})

Quick start:

./scripts/bootstrap-macos.sh
uv run garmentcad create ./projects/sample
./scripts/test.sh

Both MCP servers can create a project from the minimal Valentina-authored seed. Claude Code uses .mcp.json; local Codex clients use .codex/config.toml. Codex starts the atomic catalogs eagerly because Codex 0.144.1 does not refresh tools registered after catalog_search. The stable command_preview core tool remains available to clients that cannot refresh a dynamic catalog.

Create complete multi-piece qualification drafts without editing .val XML:

uv run python scripts/recipes/draft_qualification_pattern.py bodice /tmp/bodice --create
uv run python scripts/recipes/draft_qualification_pattern.py shirt /tmp/shirt --create
uv run python scripts/recipes/draft_qualification_pattern.py trousers /tmp/trousers --create

Run the public real-pattern qualification suite and open its HTML report:

GARMENTCAD_VALENTINA_COMMAND="$PWD/scripts/valentina-command-host.sh" \
  uv run garmentcad-corpus validate --output build/reports/real-patterns
open build/reports/real-patterns/report.html

Read the architecture, setup guide, and native Valentina host contract. The acceptance ledger separates locally proven gates from the pending real-GPU evidence. See THIRD_PARTY.md for exact upstream commits and licenses.

Current integration status

• GarmentCode native-document sync, placement, interface/stitch transactions, SDK, and MCP: implemented and tested. There is no Python-side panel geometry kernel.
• Remote worker upload, serial execution, cache, polling, artifacts, and screenshot enforcement: implemented together with the pinned Warp/GarmentCode runner, AutoDL bootstrap, and SSH tunnel; deployment supplies the body assets and an NVIDIA AutoDL instance.
• Valentina/Tape/Puzzle native command services, MCP catalog, and schema-generated typed recipes: implemented with complete reviewed handler coverage.
• Native previews include compact image resources; full coordinates, change-sets, assembly data, exports, and simulation logs remain URI-addressable on demand.
• The checked-in public corpus contains 85 .val files: the current strict run passed every self-contained production-like case; missing measurement assets and regression rejections remain visible as separate report categories.

The boundary remains explicit: this project never edits .val XML behind Valentina's back. Passing this suite establishes CAD transport and transaction fidelity, not that an unaudited agent draft is fit for manufacture.