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

1. Analyze a model: analyze_mesh to get dimensions, overhangs, etc.
2. Check printability: check_printability to detect potential issues
3. Get a recommendation: recommend_profile with your goal (draft, standard, quality, strong, speed)
4. Generate config: generate_prusaslicer_config for a ready-to-use .ini
5. Slice: slice_prusaslicer to 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/
├── index.ts              # MCP entry point + STDIO transport
├── types.ts              # TypeScript interfaces
├── config.ts             # PrusaSlicer detection
├── stl-parser.ts         # Native binary/ASCII STL parser
├── threemf-parser.ts     # 3MF parser (ZIP + XML)
├── mesh-analyzer.ts      # Geometric analysis
├── profile-engine.ts     # Recommendation engine (Bible FDM)
├── ini-writer.ts         # PrusaSlicer .ini generation
├── print-issues.ts       # Issue detection + Bible FDM diagnostics
├── orientation.ts        # Optimal orientation suggestion
├── cost-estimator.ts     # Cost/time estimation
├── filament-db.ts        # Filament database
├── prusa-cli.ts          # PrusaSlicer CLI wrapper
├── community-data.json   # Community data (MVS, diagnostics, best practices)
└── tools/                # 17 MCP tools
    ├── analyze-mesh.ts
    ├── check-printability.ts
    ├── suggest-orientation.ts
    ├── recommend-profile.ts
    ├── generate-config.ts
    ├── estimate-cost.ts
    ├── search-filament.ts
    ├── print-wizard.ts
    ├── diagnose-print.ts
    ├── slice.ts
    ├── get-current-model.ts
    ├── screenshot-prusaslicer.ts
    ├── postprocess-gcode.ts
    ├── upload-print.ts
    └── feedback.ts

Requirements

• Node.js >= 18
• PrusaSlicer (optional — only needed for slice, screenshot, get_current_model)
• Windows for screenshot feature (uses PrintWindow API)

License

MIT