README.md
Intelligent MCP Server for PrusaSlicer
PrusaMCP
Intelligent MCP Server for PrusaSlicer — 17 tools to analyze, configure and launch your 3D prints from Claude or any MCP client.
PrusaMCP is not a simple CLI wrapper. It's a 3D printing assistant that analyzes your mesh, recommends optimal settings with justification, diagnoses defects, and can drive PrusaSlicer automatically.
Built with Claude Code.
Features
- Native mesh analysis — Binary/ASCII STL and 3MF parser, zero external dependencies for parsing
- Recommendation engine — Bible FDM + official Prusa knowledge base, justification for every setting
- MVS-based speed capping — Automatic speed calculation based on material Max Volumetric Speed
- 17 MCP tools covering the full print workflow
- Post-print diagnostics — Bible FDM diagnostic tree for 9 common defects
- Filament database — 30+ filaments with temperatures, MVS, recommended surface
Tools
Analysis & Recommendation (no PrusaSlicer needed)
| Tool | Description |
|---|---|
analyze_mesh |
Geometric analysis of STL/3MF (dimensions, volume, overhangs, manifold) |
check_printability |
Issue detection: thin walls, bridges, overhangs, stability |
suggest_orientation |
Test 6 orientations with scoring (overhangs, height, adhesion) |
recommend_profile |
Full profile recommendation with per-setting justification |
generate_prusaslicer_config |
Generate PrusaSlicer-compatible .ini file |
estimate_cost |
Cost estimate (filament + electricity) and print time |
search_filament |
Search filament database (30+ entries) |
print_wizard |
All-in-one: analysis + printability + orientation + profile + questions |
diagnose_print |
Post-print diagnosis (warping, stringing, under-extrusion...) |
PrusaSlicer Integration
| Tool | Description |
|---|---|
slice_prusaslicer |
Run slicing via CLI with G-code stats |
get_current_model |
Get the model currently open in PrusaSlicer |
screenshot_prusaslicer |
Capture PrusaSlicer window (even in background) |
postprocess_gcode |
G-code post-processing (pause, filament change, etc.) |
upload_print |
Upload to OctoPrint / Prusa Connect |
Feedback & Community
| Tool | Description |
|---|---|
submit_feedback |
Submit print feedback after printing |
feedback_stats |
Feedback statistics by material/goal |
export_feedback |
Anonymized community data export |
Installation
git clone https://github.com/Noosbai/PrusaMCP.git
cd PrusaMCP
npm install
npm run build
Configuration
Claude Desktop / Claude Code
Add to your MCP configuration:
{
"mcpServers": {
"prusa-mcp": {
"command": "node",
"args": ["/path/to/PrusaMCP/build/index.js"],
"env": {
"PRUSASLICER_PATH": "C:/Program Files/Prusa3D/PrusaSlicer/prusa-slicer-console.exe"
}
}
}
}
Environment Variables
| Variable | Description | Default |
|---|---|---|
PRUSASLICER_PATH |
Path to prusa-slicer-console.exe |
Auto-detected |
PRUSASLICER_PROFILES_DIR |
PrusaSlicer profiles folder | %APPDATA%/PrusaSlicer |
OCTOPRINT_URL |
Your OctoPrint instance URL | — |
OCTOPRINT_API_KEY |
OctoPrint API key | — |
Usage
Typical Workflow
- Analyze a model:
analyze_meshto get dimensions, overhangs, etc. - Check printability:
check_printabilityto detect potential issues - Get a recommendation:
recommend_profilewith your goal (draft, standard, quality, strong, speed) - Generate config:
generate_prusaslicer_configfor a ready-to-use .ini - Slice:
slice_prusaslicerto generate G-code
Or in one command
print_wizard does everything at once: analysis + printability + orientation + profile + cost estimate + follow-up questions to refine.
Available Goals
| Goal | Description |
|---|---|
draft / prototype |
Fast, quality secondary |
standard |
Good quality/time balance |
quality / fine |
Smooth surface, fine details |
strong / structural |
Maximum mechanical strength |
vase |
Spiral vase mode |
speed |
Everything maxed out |
Supported Materials
PLA, PETG, ABS, ASA, TPU, Nylon, PC — with official Prusa temperatures, Bible FDM MVS values, drying/enclosure warnings.
Knowledge Base
The recommendation engine is built on:
- Bible de l'impression 3D FDM — Comprehensive FDM settings guide for PrusaSlicer
- Official Prusa documentation — Temperatures, MVS, reference profiles
- 9-step calibration workflow (mechanical → PID → Z → EM → MVS → retraction → cooling → PA → accel)
- Diagnostic tree for 9 common defects with causes and fixes
MVS (Max Volumetric Speed) — The Central Parameter
| Material | MVS (mm³/s) |
|---|---|
| PLA | ~15 |
| ABS/ASA | ~11 |
| PETG | ~8 |
| Nylon/PC | ~8 |
| PVA/BVOH | ~4 |
| TPU | ~1-2.5 |
Architecture
src/
Tools (17)
analyze_meshGeometric analysis of STL/3MF files including dimensions, volume, and overhangs.check_printabilityDetects issues like thin walls, bridges, overhangs, and stability.suggest_orientationTests 6 orientations with scoring based on overhangs, height, and adhesion.recommend_profileProvides full profile recommendations with per-setting justification.generate_prusaslicer_configGenerates a PrusaSlicer-compatible .ini file.estimate_costCalculates cost estimate including filament and electricity plus print time.search_filamentSearches the filament database for temperature and MVS settings.print_wizardAll-in-one tool for analysis, printability, orientation, profile, and questions.diagnose_printPost-print diagnosis for common defects like warping or stringing.slice_prusaslicerRuns slicing via CLI with G-code stats.get_current_modelRetrieves the model currently open in PrusaSlicer.screenshot_prusaslicerCaptures the PrusaSlicer window.postprocess_gcodePerforms G-code post-processing for pauses or filament changes.upload_printUploads files to OctoPrint or Prusa Connect.submit_feedbackSubmits print feedback after printing.feedback_statsProvides feedback statistics by material or goal.export_feedbackExports anonymized community data.Environment Variables
PRUSASLICER_PATHPath to prusa-slicer-console.exePRUSASLICER_PROFILES_DIRPrusaSlicer profiles folderOCTOPRINT_URLYour OctoPrint instance URLOCTOPRINT_API_KEYOctoPrint API keyConfiguration
claude_desktop_config.json
{"mcpServers": {"prusa-mcp": {"command": "node", "args": ["/path/to/PrusaMCP/build/index.js"], "env": {"PRUSASLICER_PATH": "C:/Program Files/Prusa3D/PrusaSlicer/prusa-slicer-console.exe"}}}}Try it
→Analyze this STL file and tell me if it has any thin walls or stability issues.
→Suggest the best print orientation for this model to minimize overhangs.
→Recommend a print profile for a structural part using PETG.
→Run the print wizard on my current model to prepare it for slicing.
→Diagnose why my recent print had severe stringing.