🚀 MCP 3D 打印机服务器
MCP 3D 打印机服务器是一款用于管理 3D 打印任务的工具,它支持多种 3D 打印操作,如加载、切割、保存 STL 文件,处理 G-code 等,能帮助用户更高效地进行 3D 打印工作。
🚀 快速开始
安装
使用 npm 进行安装:
npm install mcp-3d-printer-server
启动服务
通过以下命令启动 MCP 服务:
npx mcp-3d-printer-server
访问 http://localhost:3000 查看文档。
✨ 主要特性
- 支持多种 STL 文件操作,包括加载、切割、延伸基底、可视化等。
- 提供 G-code 处理功能,如确认温度设置、验证文件完整性。
- 可启动打印任务,管理 3D 打印流程。
📦 安装指南
使用 npm 进行安装:
npm install mcp-3d-printer-server
💻 使用示例
基础用法
STL 操作
mcp load-stl <文件路径>
mcp list-stl
mcp save-stl --name <名称> [--output <输出目录>]
修改操作
mcp cut-stl --plane XY --at Z=0.5
mcp cut-stl --plane XZ --at Y=1.5
mcp cut-stl --plane YZ --at X=2.0
mcp extend-base <长度>
可视化
mcp visualize-svg --output <输出路径>
mcp inspect-stl
G-code 处理
mcp confirm-temps <gcode文件> [--extruder-temp 200] [--bed-temp 60]
mcp verify-gcode <gcode文件>
打印
mcp start-print --gcodes-dir /path/to/gcodes --file-name print.gcode --print-name MyPrint --md5 hashvalue
高级用法
示例流程
- 加载 STL 文件:
mcp load-stl model.stl
- 延伸基底:
mcp extend-base 2.0
- 保存修改后的 STL 文件:
mcp save-stl --name modified-model
- 生成 G-code:
mcp generate-gcode --slicer prusaslicer --output sliced.gcode
- 确认温度设置:
mcp confirm-temps sliced.gcode --extruder-temp 200 --bed-temp 60
📚 详细文档
支持的打印机
Bambu Lab 打印机限制
由于 Bambu Lab 打印机 API 的性质,存在以下限制:
- 启动打印:需要 3MF 项目文件路径、gcode 文件名、打印名称和 MD5 哈希。当前简化的 API 尚未完全支持。
- 温度控制:Bambu API 不提供直接设置温度的方法。这需要自定义 G-code 命令。
- 文件管理:文件必须上传到打印机的“gcodes”目录。
局限性和注意事项
内存使用
- 大型 STL 文件:处理大型或复杂的 STL 文件会消耗大量内存。
- 多步骤操作:连续执行多个 STL 操作(特别是对大文件)可能会导致内存泄漏。
- 长时间运行:长期运行服务器可能会影响系统性能。
其他注意事项
- 数据持久性:所有修改仅在内存中保留,服务器关闭后不会保存。
- 错误处理:需要添加更多的异常处理和日志记录功能。
表格
属性 |
详情 |
命令 |
描述 |
load-stl |
加载 STL 文件,示例:mcp load-stl model.stl |
list-stl |
列出所有加载的 STL 文件,示例:mcp list-stl |
save-stl |
保存当前 STL 文件,示例:mcp save-stl --name save |
cut-stl |
切割 STL 文件,示例:mcp cut-stl --plane XY --at Z=0.5 |
extend-base |
延伸 STL 模型的基底,示例:mcp extend-base 2.0 |
visualize-svg |
生成 SVG 图像,示例:mcp visualize-svg --output out.svg |
inspect-stl |
查看 STL 文件的信息,示例:mcp inspect-stl |
confirm-temps |
确认 G-code 中的温度设置,示例:mcp confirm-temps gcode.gcode --extruder-temp 200 --bed-temp 60 |
verify-gcode |
验证 G-code 文件的完整性,示例:mcp verify-gcode gcode.gcode |
start-print |
启动打印任务,示例:mcp start-print --gcodes-dir /path/to/gcodes --file-name print.gcode --print-name MyPrint --md5 hashvalue |
徽章
🤝 贡献
欢迎 fork 和 pull request。请参考 CONTRIBUTING.md。
📄 许可证
MIT License