Skip to main content
Glama
snapmaker-u1-mcp

snapmaker-u1-mcp

by JSCodesTech

snapmaker-u1-mcp

MCP server for Snapmaker U1 headless slicing on Ubuntu using Snapmaker Orca.

The server exposes safe tools to inspect models, select profiles, slice to G-code, compare settings, and inspect generated runs. It does not control the printer or start prints.

Scope

  • Snapmaker Orca only; no fallback to upstream OrcaSlicer

  • headless CLI slicing; no GUI automation

  • single-material workflows first

  • all model paths restricted to U1_MODEL_DIR

  • all generated outputs restricted to U1_OUTPUT_DIR

  • generated G-code is reproducible from stored request/profile artifacts

Related MCP server: OrcaSlicer MCP

Tools

Core:

  • u1_health

  • u1_list_models

  • u1_list_profiles

  • u1_get_profile

  • u1_profile_source_chain

  • u1_diff_profiles

  • u1_explain_profile_selection

  • u1_slice

  • u1_smoke_slice

Analysis and comparison:

  • u1_analyze_gcode

  • u1_compare_slices

  • u1_compare_orientations

  • u1_transform_model

  • u1_compare_transformed_orientations

  • u1_inspect_model

  • u1_diagnose_model

  • u1_mesh_printability

  • u1_multimaterial_readiness

  • u1_orientation_preflight

Preview and metadata:

  • u1_render_preview

  • u1_render_preview_bundle

  • u1_inject_thumbnail

Recipes:

  • u1_list_recipes

  • u1_get_recipe

  • u1_compare_recipes

Run management:

  • u1_list_runs

  • u1_get_run

  • u1_get_run_logs

  • u1_search_runs

  • u1_export_run_report

  • u1_reproduce_run

  • u1_delete_run

Install

git clone git@github.com:JSCodesTech/snapmaker_u1_mcp.git
cd snapmaker_u1_mcp
python3 -m venv .venv
.venv/bin/pip install -e '.[test]'

Configure paths:

export SNAPMAKER_ORCA_BIN=/path/to/snapmaker-orca/AppRun
# or
export SNAPMAKER_ORCA_APPIMAGE=/path/to/Snapmaker-Orca.AppImage

export U1_MODEL_DIR=$HOME/3D_Printing/models
export U1_OUTPUT_DIR=$HOME/3D_Printing/output
mkdir -p "$U1_MODEL_DIR" "$U1_OUTPUT_DIR"

Optional if profiles are not auto-discovered:

export SNAPMAKER_PROFILE_DIR=/path/to/Snapmaker/Orca/resources/profiles

Check health:

snapmaker-u1-mcp health

MCP configuration

A template is included at examples/mcp/pi-mcp.json. Copy it into your MCP client configuration and replace the absolute paths.

Keep your personal MCP config out of git.

How to use the MCP

Use the MCP as a batch/reproducibility assistant, not as a replacement for manually reviewing prints in Snapmaker Orca.

Good MCP use cases:

  • compare a small number of slice variants

  • check model dimensions and printability warnings

  • test orientations using local transformed model copies

  • inspect profiles and explain compatibility

  • analyze generated G-code

  • export run reports for later review

Example prompts:

Check Snapmaker U1 health and list my PLA profiles for a 0.4 mm nozzle.
Inspect hase.stl, run printability checks, and render a summary preview.
Compare baseline, pla-draft, and pla-strong for hase.stl. Return only a compact table and recommendation.
Compare flat and X90 using transformed orientations, not Snapmaker Orca CLI rotation flags.

Keep usage low-cost by being specific. Prefer 2–4 variants per request and ask for compact summaries. Use Snapmaker Orca GUI for final visual review, manual support decisions, and one-off simple prints.

CLI examples

List models and profiles:

snapmaker-u1-mcp list-models
snapmaker-u1-mcp list-profiles --nozzle 0.4 --material PLA
snapmaker-u1-mcp get-profile process "0.20 Standard @Snapmaker U1 (0.4 nozzle)"
snapmaker-u1-mcp profile-source-chain process "0.20 Standard @Snapmaker U1 (0.4 nozzle)"
snapmaker-u1-mcp list-recipes
snapmaker-u1-mcp compare-recipes hase.stl \
  --process "0.20 Standard @Snapmaker U1 (0.4 nozzle)" \
  --filament "Snapmaker PLA Basic @U1" \
  --recipes '["pla-draft","pla-strong"]'

Inspect a model:

snapmaker-u1-mcp inspect-model hase.stl
snapmaker-u1-mcp diagnose-model hase.stl
snapmaker-u1-mcp mesh-printability hase.stl
snapmaker-u1-mcp multimaterial-readiness --model hase.stl
snapmaker-u1-mcp orientation-preflight hase.stl
snapmaker-u1-mcp transform-model hase.stl --rotate-x 90
snapmaker-u1-mcp render-preview hase.stl --view summary

Slice:

snapmaker-u1-mcp slice hase.stl \
  --process "0.20 Standard @Snapmaker U1 (0.4 nozzle)" \
  --filament "Snapmaker PLA Basic @U1"

Compare local mesh-transformed orientations without Snapmaker Orca CLI rotation flags:

snapmaker-u1-mcp compare-transformed-orientations hase.stl \
  --process "0.20 Standard @Snapmaker U1 (0.4 nozzle)" \
  --filament "Snapmaker PLA Basic @U1" \
  --orientations '[{"name":"flat"},{"name":"x90","rotate_x":90},{"name":"y90","rotate_y":90}]'

Slice with controlled overrides:

snapmaker-u1-mcp slice hase.stl \
  --process "0.20 Standard @Snapmaker U1 (0.4 nozzle)" \
  --filament "Snapmaker PLA Basic @U1" \
  --overrides '{"wall_loops":3}'

Inspect generated runs:

snapmaker-u1-mcp list-runs --limit 10
snapmaker-u1-mcp get-run RUN_ID
snapmaker-u1-mcp get-run-logs RUN_ID --tail 2000
snapmaker-u1-mcp search-runs --model hase --status ok
snapmaker-u1-mcp export-run-report RUN_ID

Delete a generated run only when intentional:

snapmaker-u1-mcp delete-run RUN_ID --confirm

Run artifacts

Each slice creates a run directory under U1_OUTPUT_DIR containing:

request.json
command.json
profiles/
stdout.log
stderr.log
analysis.json
plate_1.gcode

Original Snapmaker profiles are never modified.

Notes

Snapmaker Orca Linux CLI 01.10.01.50 has been observed to crash with some profile fields and non-zero CLI rotation transforms. This server reports those failures and keeps logs; it does not silently switch slicers.

For setup and troubleshooting, see:

  • docs/INSTALL.md

  • docs/MCP_USAGE.md

  • docs/TROUBLESHOOTING.md

  • docs/ARCHITECTURE.md

  • examples/requests/

Tests

python -m pytest
python -m pytest --cov=snapmaker_u1_mcp --cov-report=term-missing --cov-fail-under=80

Acknowledgements

This project was built with awareness of Diterex/orcaslicer-mcp, but is a smaller Snapmaker U1/Snapmaker Orca-focused implementation.

Available Tools

33 tools
u1_analyze_gcodeC

Analyze a generated G-code file under U1_OUTPUT_DIR.

Inputs: gcode (required), requested_material.

u1_compare_orientationsC

Slice and compare controlled orientation variants.

Inputs: model (required), process (required), filament (required), orientations (required), +3 more.

u1_compare_recipesC

Compare built-in recipe override sets using the same process/filament.

Inputs: model (required), process (required), recipes (required), filament (required), +2 more.

u1_compare_slicesC

Slice and compare multiple process/override variants.

Inputs: model (required), filament (required), variants (required), nozzle, +1 more.

u1_compare_transformed_orientationsD

Transform STL copies locally, then slice without Snapmaker Orca CLI rotation flags.

Inputs: model (required), process (required), filament (required), nozzle, +3 more.

u1_delete_runA

Delete one generated run directory; requires confirm=true.

Inputs: run_id (required), confirm.

u1_diagnose_modelB

Return practical pre-slice model diagnostics and suggestions.

Inputs: model (required).

u1_diff_profilesC

Diff two resolved profiles of the same kind.

Inputs: kind (required), left (required), right (required).

u1_explain_profile_selectionC

Validate and summarize a machine/process/filament selection.

Inputs: process (required), filament (required), nozzle, machine.

u1_export_run_reportC

Write a Markdown summary report into a run directory.

Inputs: run_id (required).

u1_export_runs_reportC

Write a Markdown comparison report for multiple runs.

Inputs: run_ids (required), name.

u1_get_profileA

Return one resolved machine/process/filament profile by exact name or file stem.

Inputs: kind (required), name (required).

u1_get_recipeC

Return one built-in override recipe.

Inputs: name (required).

u1_get_runB

Return compact metadata and artifact availability for one run.

Inputs: run_id (required).

u1_get_run_logsB

Return stdout/stderr log tails for one run on explicit request.

Inputs: run_id (required), tail.

u1_healthB

Check Snapmaker Orca CLI, U1 profile discovery, and output directory access.

Inputs: no named parameters.

u1_inject_thumbnailC

Inject an SVG preview as comment metadata into a copied G-code file.

Inputs: gcode (required), model (required), view.

u1_inspect_modelC

Inspect STL/3MF dimensions and basic U1 fit information.

Inputs: model (required).

u1_list_modelsA

List STL/3MF models inside U1_MODEL_DIR.

Inputs: no named parameters. Returns: result

u1_list_profilesB

List discovered Snapmaker U1 profile names by default; set details=true for full metadata.

Inputs: nozzle, details, material, layer_height.

u1_list_recipesA

List built-in override recipes for common slicing goals.

Inputs: no named parameters.

u1_list_runsC

List recent generated slice runs with compact metadata.

Inputs: limit.

u1_mesh_printabilityB

Estimate simple STL overhang/contact metrics without slicing.

Inputs: model (required), overhang_angle.

u1_multimaterial_readinessA

Report current multi-material support/readiness without enabling it.

Inputs: model.

u1_orientation_preflightB

Preflight axis-aligned orientation candidates without slicing rotated variants.

Inputs: model (required).

u1_profile_source_chainC

Return child-to-parent profile inheritance source chain.

Inputs: kind (required), name (required).

u1_render_previewC

Generate a lightweight SVG preview from model dimensions.

Inputs: model (required), view.

u1_render_preview_bundleC

Generate summary/top/front/side SVG previews for a model.

Inputs: model (required).

u1_reproduce_runC

Re-slice a previous regular run from stored request metadata.

Inputs: run_id (required), verbose.

u1_search_runsB

Search recent runs by model, filament, and/or status.

Inputs: limit, model, status, filament.

u1_sliceC

Slice an STL/3MF model for Snapmaker U1 and return compact G-code analysis; set verbose=true for logs.

Inputs: model (required), process (required), filament (required), nozzle, +3 more.

u1_smoke_sliceC

Run Phase 0 real smoke slice with explicit process and filament profiles.

Inputs: model (required), process (required), filament (required), nozzle, +1 more.

u1_transform_modelB

Create a locally transformed STL copy under U1_OUTPUT_DIR/transformed.

Inputs: model (required), rotate, rotate_x, rotate_y.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 33 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, such as render_preview vs render_preview_bundle and compare_slices vs compare_orientations. A few potential overlaps exist (e.g., inspect_model vs diagnose_model, mesh_printability vs orientation_preflight) but they address different aspects, so ambiguity is low overall.

    Naming Consistency4/5

    All tools share the u1_ prefix and use snake_case. Most follow a verb_noun pattern (e.g., list_models, get_profile, export_run_report), though a few like 'health', 'profile_source_chain', and 'mesh_printability' are noun phrases. This deviation is minor and the naming remains predictable.

    Tool Count2/5

    With 33 tools, the surface is large and feels heavy. Many are variations on similar themes (e.g., three compare tools, two render preview tools, and extensive run management), suggesting some consolidation could reduce the count without losing functionality. The domain is complex, but this exceeds the typical well-scoped range.

    Completeness4/5

    The tool set covers the full slicing workflow: model inspection, profile management, slicing, run tracking, comparisons, transformations, diagnostics, and preview rendering. Minor gaps exist (e.g., no profile editing or model upload), but the core lifecycle is well-supported and no critical dead ends are apparent.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables headless slicing with OrcaSlicer, preset management, G-code analysis, and printer control over LAN for Klipper, OctoPrint, Prusa, Duet, Elegoo, and Bambu printers.
      15
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Wraps the OrcaSlicer CLI to enable AI agents to slice 3D models, run parameter sweeps, and analyze G-code.
      111 PyPI
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables LLM clients to slice, paint, and verify 3D prints through the installed slicer's command line for any installed Bambu printer, nozzle, and filament, with settings per object type. It never sends jobs to a printer.
      11
      MIT