mcpField
M
meshy-3d-printing

meshy-3d-printing

github.com/meshy-devCreative & media1061.7k installsUpdated 2w ago
Repository

About meshy-3d-printing

A skill for using Meshy CLI 0.4.3 to prepare and deliver 3D-print files, including printability checks and optional slicer handoff. It guides workflows for existing models, generated designs, multicolor prints, and Creative Lab products.

Key features

  1. 01Local OBJ scaling and orientation
  2. 02Printability analysis and repair
  3. 03Single- and multicolor print workflows
  4. 04Creative Lab product workflows
  5. 05Slicer detection and handoff

Use cases

  1. 01Prepare an existing OBJ for printing
  2. 02Generate and check a model for printing
  3. 03Create a multicolor or split-part print
  4. 04Build a Creative Lab product

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/meshy-dev/meshy-3d-agent --skill meshy-3d-printing

After installing, type/meshy-3d-printingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
delivery.md
printing.md
setup.md
troubleshooting.md

Details

From the project README

Meshy 3D Printing

Use Meshy CLI 0.4.3 to deliver the requested print files at the intended size, with analysis/repair results where applicable and a slicer handoff when requested. This skill is self-contained. Ordinary digital assets belong to meshy-3d-generation.

NeedReference
CLI runner, credentials, or output locationSetup
Local preparation, cloud generation, or product workflowPrinting recipes
Cost, waiting, preview, delivery, or finding a previous modelDelivery
Failed or uncertain operationTroubleshooting

Read relevant sections as needed. Recipes illustrate valid commands; select only the stages needed for the user's output.

Choose local or cloud work

RequestRoute
Scale, orient or ground an existing OBJLocal mesh prepare-print; no auth or balance
Open an existing STL or 3MFLocal slicer detect and slicer open; no auth or balance
White model from text or photoGenerate geometry without textures; analyze/repair as needed; prepare the file
Multicolor modelGenerate/reuse geometry; analyze/repair as needed; texture; multi-color-print
Print in separate parts (build plate, colours per part, fewer supports)Generate/reuse geometry; auto-split; slice the parts
Creative Lab figure, vinyl figure, brick figure, lamp, keychain, fridge magnet, keycap or pixel fidget boardPrototype → review → build → select product artifacts
Creative Lab collapsible fidgetOne create from the photo → STL

A figurine does not by itself require Creative Lab. Infer the route from the intended product; ask about size, color or style only when the missing choice materially changes the result. For an existing model, distinguish local preparation from cloud printability analysis; a local dimension check cannot establish full printability.

Cloud authorization

Resolve the runner automatically using Setup (compatible meshy or npm exec --yes [email protected] -- meshy …). Local-only work stops at runner setup. Cloud work reuses a verified session. If login is needed, keep auth login --device running, show its URL and user code in commentary/progress, never a final answer, and await the same tool session in this turn. After it exits, verify auth status and resume the print job. Do not ask for a "done" message or credentials in chat; Setup has the host wait procedure.

Printing-specific constraints

  • Repair changes geometry and drops textures. Use repaired geometry downstream and retexture before multicolor output. Use analysis when functional parts, thin features or other requirements make it relevant, with the printer type and print size when known so wall thickness is checked too; its report does not establish material suitability.
  • Prepare a Y-up OBJ as a new Z-up file at the requested height, centered and grounded. Do not repeat the transform or apply it to STL, 3MF, or relief product output. A multicolor 3MF requires no OBJ conversion. Product ZIPs and optional lamp bases have distinct handling in Printing recipes.
  • API, downloads and geometry operations use the CLI. Local inputs have a 50 MiB limit, and a local model must be GLB or glTF (multicolor: GLB); an STL, OBJ or FBX goes to Meshy only as an http(s) URL. Business commands use --output-schema v1 --format json --no-update-check; writes carry the resolved --workspace WORKSPACE. Read returned paths and IDs rather than guessing.
  • Submit cloud tasks once with create --async, retain their resource and lineage, and wait on the same task. Keep the turn active during waits. Unknown submission and interrupted downloads are recovery cases, not permission to generate again.
  • Work within the approved scope and budget; propose additional paid stages before spending. Delivery describes applicable estimates. Local preparation and printability analysis are free.

Finish the handoff

Show an available rendered preview and deliver file paths, dimensions, analysis/repair status and reported charges. Launch a detected slicer only when requested or already authorized; launch_requested does not prove successful import or start a physical printer. If no suitable slicer is installed, still deliver the files. Explain relevant remaining checks, such as supports and wall thickness, without describing an untested model as guaranteed printable.

Comments

Markdown supported