MCP 3D Printer Server

🚀 MCP 3D Printer Server Documentation

MCP 3D Printer Server is a tool for controlling and managing 3D printers. It supports interaction through RESTful APIs, can handle STL files, generate GCode, monitor printing progress, and perform basic temperature control.

✨ Features

• STL File Operations: Supports reading, writing, and modifying STL model files.
• GCode Generation: Integrates slicing tools (such as PrusaSlicer) to generate printing code.
• Temperature Monitoring and Control: Provides the ability to set and monitor the printer's temperature.
• File Management: Supports uploading and downloading files to the printer.
• Print Status Query: Returns status information of the current print task.

📦 Installation

1. First, ensure that Node.js (recommended version 18.0.0 or higher) is installed on your system.
2. Install the MCP 3D Printer Server using npm:

   npm install mcp-3d-printer-server
   

3. Start the service:

   node index.js
   

📚 Documentation

API Overview

Request and Response Examples

Upload Model

Request Example:

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

file=@model.stl

Response Example:

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

Process Model

Request Example:

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

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

Response Example:

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

🚀 Usage Guide

Extend Base

Used to increase the base height of the model to prevent printing failures.

Usage Method:

1. Upload an STL file to /api/models.
2. Send a processing request including the extend_base operation.

Example:

{
  "operations": ["extend_base"]
}

Slicing

Integrates PrusaSlicer for slicing and generates GCode required for printing.

Usage Method:

1. Ensure that PrusaSlicer is installed and configured.
2. Include the slice operation in the processing request.

Example:

{
  "operations": ["slice"]
}

Temperature Confirmation

Checks the recommended printing temperature settings for the model.

Usage Method: Include the check_temperatures operation in the processing request, and the server will return the recommended temperature parameters.

⚠️ Bambu Lab Printer Limitations

Special Notes

• Start Print Task: Must be called through a specific API.
• Temperature Control: Direct control may be restricted, and the provided interface should be used.
• File Management: Files must meet specific format and size requirements.

🔧 Technical Details

Extend Base Operation

function extendBase(model) {
    // Logic to extend the base
}

Slicing Process

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

⚠️ Limitations and Precautions

Memory Usage

When processing large models, ensure that the server has sufficient memory.

Performance Considerations

• Multithreading Support: It is recommended to run on a multi - core processor to improve performance.
• Disk Space: Ensure sufficient storage space for processing and storing STL files and GCode.

Testing Recommendations

1. Conduct thorough testing before deploying in a production environment.
2. Use models of different sizes and complexities for verification.

📄 Badges

💻 Usage Examples

Basic Service Startup

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

app.get('/api/models', (req, res) => {
    // Logic to return the model list
});

app.post('/api/models', (req, res) => {
    // Logic to handle file uploads
});

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

📚 References

1. Node.js Official Documentation
2. PrusaSlicer API Documentation
3. RESTful API Design Guide

If you need further support or encounter problems, please contact technical support.