使用说明
PrusaMCP
PrusaSlicer的智能MCP服务器 --17个工具，用于从Claude或任何MCP客户端分析、配置和启动您的3D打印。
PrusaMCP不是一个简单的CLI包装器。这是一 3D打印助手 它可以分析网格，推荐带对齐的最佳设置，诊断缺陷，并可以自动驱动PrusaSlicer。
内置于 Claude 代码.
特性
- 原生网格分析 --二进制/ASCII STL和3MF解析器，解析无外部依赖
- 推荐引擎 --圣经FDM+官方Prusa知识库，每种设置的理由
- 基于MVS的速度上限 --基于物料最大体积速度的自动速度计算
- 17个MCP工具 涵盖整个打印工作流程
- 打印后诊断 --9种常见缺陷的圣经FDM诊断树
- 灯丝数据库 --30+带温度、MVS、推荐表面的长丝
工具
分析和建议（不需要PrusaSlicer）
| 工具 | 说明 |
|---|---|
analyze_mesh |
STL/3MF的几何分析（尺寸、体积、悬垂、歧管） |
check_printability |
问题检测：薄壁、桥梁、悬挑、稳定性 |
suggest_orientation |
对6个方向进行评分测试（悬垂、高度、附着力） |
recommend_profile |
完整的配置文件推荐，并按设置进行说明 |
generate_prusaslicer_config |
生成与PrusaSlicer兼容的.ini文件 |
estimate_cost |
成本估算（灯丝+电力）和打印时间 |
search_filament |
搜索灯丝数据库（30+条） |
print_wizard |
一体化：分析+可印刷性+方向+简介+问题 |
diagnose_print |
打印后诊断（翘曲、串线、挤压不足……） |
PrusaSlicer集成
| 工具 | 说明 |
|---|---|
slice_prusaslicer |
使用G代码统计信息通过CLI运行切片 |
get_current_model |
获取PrusaSlicer中当前打开的模型 |
screenshot_prusaslicer |
捕获PrusaSlicer窗口（即使在后台） |
postprocess_gcode |
G代码后处理（暂停、灯丝更换等） |
upload_print |
上传到OctoPrint/Prusa Connect |
反馈与社区
| 工具 | 说明 |
|---|---|
submit_feedback |
打印后提交打印反馈 |
feedback_stats |
按物料/目标分类的反馈统计 |
export_feedback |
匿名社区数据导出 |
安装
git clone https://github.com/Noosbai/PrusaMCP.git
cd PrusaMCP
npm install
npm run build
配置
克劳德桌面/克劳德代码
添加到MCP配置中：
{
"mcpServers": {
"prusa-mcp": {
"command": "node",
"args": ["/path/to/PrusaMCP/build/index.js"],
"env": {
"PRUSASLICER_PATH": "C:/Program Files/Prusa3D/PrusaSlicer/prusa-slicer-console.exe"
}
}
}
}
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
PRUSASLICER_PATH |
通往 prusa-slicer-console.exe |
自动检测 |
PRUSASLICER_PROFILES_DIR |
PrusaSlicer配置文件文件夹 | %APPDATA%/PrusaSlicer |
OCTOPRINT_URL |
您的OctoPrint实例URL | -- |
OCTOPRINT_API_KEY |
OctoPrint API密钥 | - |
用法
典型工作流程
- 分析模型:
analyze_mesh获取尺寸、悬垂等。 - 检查打印性能:
check_printability检测潜在问题 - 获得推荐:
recommend_profile有你的目标（选秀、标准、质量、实力、速度） - 生成配置:
generate_prusaslicer_config对于即用型.ini - 切片:
slice_prusaslicer生成G代码
或者在一个命令中
print_wizard 一次完成所有事情：分析+可印刷性+定位+轮廓+成本估算+后续问题以进行改进。
可用目标
| 目标 | 描述 |
|---|---|
draft / prototype |
快速、优质的二级 |
standard |
良好的质量/时间平衡 |
quality / fine |
表面光滑，细节精致 |
strong / structural |
最大机械强度 |
vase |
螺旋花瓶模式 |
speed |
一切都搞砸了 |
支持的材料
PLA、PETG、ABS、ASA、TPU、尼龙、PC——带有官方Prusa温度、圣经FDM MVS值、干燥/外壳警告。
知识库
推荐引擎基于以下内容构建：
- FDM 3D打印圣经 --PrusaSlicer的全面FDM设置指南
- Prusa官方文件 --温度、MVS、参考曲线
- 9步校准工作流程 （机械→ PID → Z → EM → MVS → 撤回→ 冷却→ PA → 加速）
- 诊断树 9种常见缺陷及其原因和修复方法
MVS（最大体积速度）——核心参数
| 材料 | MVS（mm³/s） |
|---|---|
| PLA | ~15 |
| ABS/ASA | ～11 |
| 宠物 | ~8 |
| 尼龙/PC | ~8 |
| PVA/BVOH | ~4 |
| TPU | ~1-2.5 |
建筑学
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
需求
- Node.js >= 18
- 普鲁萨切片器 （可选——仅切片、截图、get_current_model需要）
- 视窗 用于屏幕截图功能（使用PrintWindow API）
许可证
麻省理工学院
