MCP 3D Printer Server

🚀 MCP 3D 打印機服務器文檔

MCP 3D 打印機服務器是一款用於控制和管理 3D 打印機的實用工具。它藉助 RESTful API 實現交互，能對 STL 文件進行處理、生成 GCode、監控打印進度，還可進行基本的溫度控制，為 3D 打印工作提供了全面的支持。

🚀 快速開始

MCP 3D 打印機服務器支持通過 RESTful API 進行交互，能夠處理 STL 文件、生成 GCode、監控打印進度並進行基本的溫度控制。

✨ 主要特性

• STL 文件操作：支持讀取、寫入和修改 STL 模型文件。
• GCode 生成：集成切片工具（如 PrusaSlicer）以生成打印代碼。
• 溫度監控與控制：提供設置和監控打印機溫度的能力。
• 文件管理：支持上傳和下載文件到打印機。
• 打印狀態查詢：返回當前打印任務的狀態信息。

📦 安裝指南

1. 首先，確保系統已安裝 Node.js（推薦版本 18.0.0 或更高）。
2. 使用 npm 安裝 MCP 3D 打印機服務器：

   npm install mcp-3d-printer-server
   

3. 啟動服務：

   node index.js
   

📚 詳細文檔

接口概述

請求與響應示例

上傳模型

請求示例：

POST /api/models
Content-Type: multipart/form-data

file=@model.stl

響應示例：

{
  "status": "success",
  "message": "Model uploaded successfully.",
  "modelId": "12345"
}

處理模型

請求示例：

POST /api/models/12345/process
Content-Type: application/json

{
  "operations": ["extend_base", "slice", "check_temperatures"]
}

響應示例：

{
  "status": "success",
  "message": "Model processing started.",
  "taskId": "abc123"
}

操作指南

擴展基底

用於增加模型的基底高度，防止打印失敗。

使用方法：

1. 上傳 STL 文件到 /api/models。
2. 發送處理請求幷包含 extend_base 操作。

示例：

{
  "operations": ["extend_base"]
}

切片

集成 PrusaSlicer 進行切片處理，生成打印所需的 GCode。

使用方法：

1. 確保已安裝並配置了 PrusaSlicer。
2. 在處理請求中包含 slice 操作。

示例：

{
  "operations": ["slice"]
}

溫度確認

檢查模型的推薦打印溫度設置。

使用方法： 在處理請求中包含 check_temperatures 操作，服務器將返回建議的溫度參數。

Bambu Lab 打印機限制

特殊注意事項

• 啟動打印任務：必須通過特定的 API 調用。
• 溫度控制：直接控制可能受限，需使用提供的接口。
• 文件管理：文件必須符合特定格式和大小要求。

🔧 技術細節

擴展基底操作

function extendBase(model) {
    // 實現擴展基底的邏輯
}

切片處理

const slicer = new PrusaSlicer();
slicer.process('model.stl', 'output.gcode');

限制與注意事項

內存使用

處理大模型時，需確保服務器有足夠的內存。

性能考慮

• 多線程支持：推薦在多核處理器上運行以提升性能。
• 磁盤空間：確保足夠的存儲空間用於處理和存儲 STL 文件及 GCode。

測試建議

1. 在生產環境部署前，先進行充分的測試。
2. 使用不同尺寸和複雜度的模型進行驗證。

標誌

💻 使用示例

基礎用法

const express = require('express');
const app = express();

app.get('/api/models', (req, res) => {
    // 返回模型列表邏輯
});

app.post('/api/models', (req, res) => {
    // 處理文件上傳邏輯
});

app.listen(3000, () => {
    console.log('Server running on port 3000');
});

參考資料

1. Node.js 官方文檔
2. PrusaSlicer API 文檔
3. RESTful API 設計指南

如需進一步支持或遇到問題，請聯繫技術支持。