DMontgomery40/bambu-printer-mcp

🖨️ MCP server chuyên dụng cho máy in 3D Bambu Lab — từ cắt model đến in thực tế

Quản lý toàn bộ quy trình in 3D Bambu Lab ngay trong Claude — cắt STL/3MF, ánh xạ màu sắc AMS thông minh, upload FTPS và khởi động in qua MQTT.

bambu-printer-mcp là một Model Context Protocol server tập trung hoàn toàn vào phần cứng Bambu Lab, cho phép Claude Desktop hoặc Claude Code điều khiển trực tiếp máy in, thao tác tệp STL và quản lý quy trình làm việc 3MF hoàn chỉnh. Đây là phiên bản được tinh gọn hóa từ mcp-3D-printer-server, loại bỏ hoàn toàn hỗ trợ OctoPrint, Klipper, Duet, Repetier, Prusa Connect và Creality Cloud — chỉ giữ lại cốt lõi cho Bambu Lab.

✨ Điểm nổi bật

• Ánh xạ AMS tự động bằng RFID: giải quyết yêu cầu màu sắc 3MF chống lưng chống hàng, hỗ trợ cùng SKU khác màu.
• Quản lý kho màu AMS có cấu trúc: tên trays, phân giải hồ sơ (exact-model-nozzle/model/generic), độ tin cậy khớp.
• Chụp ảnh camera nội thất: JPEG từ camera, TCP port 6000 (A1/P1S/P1P) hoặc RTSP qua ffmpeg (X1/P2S/H2).
• Điều khiển in chi tiết: tạm dừng, tiếp tục, hủy, bỏ qua vật thể riêng lẻ trong lần in đa vật thể.
• Chẩn đoán HMS: tóm tắt lỗi chỉ đọc qua tài nguyên MCP printer://{host}/hms.
• Tích hợp Blender: điều khiển Blender thông qua MCP để xử lý model 3D.
• Hỗ trợ máy in H2: đường dẫn in an toàn với định dạng project_file và ams_mapping2.
• Cắt góc lệch BambuStudio CLI: tự động làm phẳng bằng BAMBU_CLI_FLATTEN=true.
• Điều khiển sấy AMS: bật/tắt sấy cho AMS Pro/AMS-HT qua lệnh MQTT print.ams_control.

💡 Vì sao đáng chú ý

Không phải là một server 3D chung — bambu-printer-mcp tập trung hoàn toàn vào sinh thái Bambu Lab, xử lý mọi từ cắt model đến in thực tế trong một quy trình liên tục. Điểm mạnh nằm ở khả năng ánh xạ AMS thông minh và hỗ trợ máy in H2 với các bản vá firmware đặc biệt.

Phù hợp với người dùng Bambu Lab muốn tự động hóa toàn bộ quy trình in 3D từ Claude, đặc biệt khi làm việc với nhiều màu sắc và máy in H2 series.

#BambuLab #3DPrinting #MCP #ModelContextProtocol #TypeScript #OpenSource #TiniX