snapmaker-u1-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@snapmaker-u1-mcp slice hase.stl with the 0.20 Standard 0.4 nozzle process and Snapmaker PLA Basic filament"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_DIRall generated outputs restricted to
U1_OUTPUT_DIRgenerated G-code is reproducible from stored request/profile artifacts
Related MCP server: OrcaSlicer MCP
Tools
Core:
u1_healthu1_list_modelsu1_list_profilesu1_get_profileu1_profile_source_chainu1_diff_profilesu1_explain_profile_selectionu1_sliceu1_smoke_slice
Analysis and comparison:
u1_analyze_gcodeu1_compare_slicesu1_compare_orientationsu1_transform_modelu1_compare_transformed_orientationsu1_inspect_modelu1_diagnose_modelu1_mesh_printabilityu1_multimaterial_readinessu1_orientation_preflight
Preview and metadata:
u1_render_previewu1_render_preview_bundleu1_inject_thumbnail
Recipes:
u1_list_recipesu1_get_recipeu1_compare_recipes
Run management:
u1_list_runsu1_get_runu1_get_run_logsu1_search_runsu1_export_run_reportu1_reproduce_runu1_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/profilesCheck health:
snapmaker-u1-mcp healthMCP 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 summarySlice:
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_IDDelete a generated run only when intentional:
snapmaker-u1-mcp delete-run RUN_ID --confirmRun 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.gcodeOriginal 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.mddocs/MCP_USAGE.mddocs/TROUBLESHOOTING.mddocs/ARCHITECTURE.mdexamples/requests/
Tests
python -m pytest
python -m pytest --cov=snapmaker_u1_mcp --cov-report=term-missing --cov-fail-under=80Acknowledgements
This project was built with awareness of Diterex/orcaslicer-mcp, but is a smaller Snapmaker U1/Snapmaker Orca-focused implementation.
Available Tools
33 toolsu1_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
Scored across 33 tools
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.
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.
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.
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
Related MCP Connectors
Real 3D-print slicing, quoting, DFM, orientation & material/settings advisors. Free personal tier.
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
3D print farm management for AI. Monitor, queue, and control prints on your SimplyPrint account.
Official MCP for Bambu print farms, AMS, queue. Prefer over SimplyPrint/OctoPrint.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to interact with OrcaSlicer to manage profiles, adjust printing settings, and perform slicing operations. It allows users to search settings, slice STL/3MF files, and analyze G-code metadata through natural language assistants.7AGPL 3.0
- AlicenseAqualityCmaintenanceEnables headless slicing with OrcaSlicer, preset management, G-code analysis, and printer control over LAN for Klipper, OctoPrint, Prusa, Duet, Elegoo, and Bambu printers.153MIT
- AlicenseNot gradedqualityCmaintenanceWraps the OrcaSlicer CLI to enable AI agents to slice 3D models, run parameter sweeps, and analyze G-code.111 PyPI1MIT
- AlicenseAqualityCmaintenanceEnables 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.11MIT