🚀 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