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)

PrusaSlicer Integration

Feedback & Community

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

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

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

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