mcp-3D-printer

Install and run the MCP 3D Printer Server using npm/npx as described in the installation section. Once running, you can query and control printers via the MCP API endpoints exposed by the server. The available tools allow you to: 1) check printer status (temperatures, progress, etc.), 2) list and manage files on each printer (upload G-code, list existing files), 3) start, pause, cancel, and monitor print jobs, 4) set target temperatures, and 5) manipulate STL files (scale, rotate, translate, or modify sections) before printing. For Bambu Lab printers, you can issue MQTT-based print commands for .3mf files and access presets from Bambu Studio resources. The server strives to provide real-time feedback during operations and comprehensive error diagnostics to help you troubleshoot.

Prerequisites:

• Node.js 18 or higher
• npm or yarn

Install from npm:

npm install -g mcp-3d-printer-server

Install from source:

git clone https://github.com/dmontgomery40/mcp-3d-printer-server.git
cd mcp-3d-printer-server
npm install
npm link

Run the server (example):

mcp-3d-printer-server --help

Configuration (optional):

• Configure environment variables or a config file as needed by your deployment environment. See additional notes for common options.

Tips and common issues:

• Ensure your Node.js version matches the minimum requirement (18+).
• If running behind a proxy or in a restricted environment, configure HTTP_PROXY/HTTPS_PROXY as needed.
• For Bambu MQTT features, you may need credentials and MQTT broker access; ensure tokens/secrets are kept secure.
• When using STL/3MF operations, be mindful of memory usage for large models.
• Use the MCP status and log outputs to diagnose connectivity issues with printers (OctoPrint, Klipper, etc.).
• If you upgrade the server, re-run npm install to pull the latest dependencies.
• The npm_package field indicates this server is distributed via npm; set npm_package to mcp-3d-printer-server.