How do I use repetier-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@repetier-mcp What's the hotend temperature?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

repetier-mcp

by Nstalej

Overview Schema Source Related Servers Discussions Admin

Python

Local

repetier-mcp

MCP server for Repetier-Host / Repetier-Server -- monitor, control and diagnose your 3D printer with AI.

Connect Claude (or any MCP-compatible AI) directly to your 3D printer. Get live temperature readings, job progress, intelligent error diagnosis, and printer-specific repair guidance -- including a built-in knowledge base for the Artillery Sidewinder X1.

English README | Espanol

What you can do

Tell Claude...	What happens
"What's the printer temperature?"	Returns hotend + bed temps in real time
"My printer has layer shifting problems"	Diagnoses causes, gives step-by-step repair guide
"Send M503 to read current settings"	Sends G-code, returns EEPROM values
"Check if temps are stable"	Takes 5 readings over 10s, detects instability
"Upload and print benchy.gcode"	Uploads file to server and starts printing
"Pause the print"	Pauses current job via Repetier-Server
"Set bed temperature to 60"	Sets heated bed to 60C
"What port is my printer on?"	Scans serial ports and auto-detects printer

Related MCP server: Bambuddy MCP Server

Quick start

Install from GitHub

pip install git+https://github.com/Nstalej/repetier-mcp.git

Or with uv (recommended -- faster, no dependency conflicts):

pip install uv
uv pip install git+https://github.com/Nstalej/repetier-mcp.git

For serial mode (direct USB), also install pyserial:

pip install "repetier-mcp[serial] @ git+https://github.com/Nstalej/repetier-mcp.git"

For development:

git clone https://github.com/Nstalej/repetier-mcp.git
cd repetier-mcp
pip install -e ".[dev]"
pytest

Connection Modes

repetier-mcp supports two connection modes:

Mode 1: Repetier-Server (recommended)

Connects via HTTP REST API to Repetier-Server running on your network. Supports all features including file upload, pause/resume, and job management.

Mode 2: Direct Serial (USB)

Connects directly to the printer via USB/serial port (pyserial). Classic mode for Repetier-Host users. Requires the serial extra.

Configuration

Repetier-Server mode

Variable	Default	Description
`REPETIER_MODE`	`serial`	Set to `server`
`REPETIER_SERVER_URL`	`http://localhost:3344`	Full URL of Repetier-Server
`REPETIER_SERVER_APIKEY`	(empty)	API key from Repetier-Server
`REPETIER_PRINTER_SLUG`	(empty)	Printer slug/name in server
`PRINTER_MODEL`	`sidewinder_x1`	Printer model for diagnostics

Direct USB / serial mode

Variable	Default	Description
`REPETIER_MODE`	`serial`	Connection mode: `serial` or `server`
`REPETIER_PORT`	(auto)	Serial port, e.g. `/dev/ttyUSB0` or `COM3`
`REPETIER_BAUD`	`115200`	Baud rate -- use `250000` for Sidewinder X1
`PRINTER_MODEL`	`sidewinder_x1`	Printer model for targeted diagnostics

Auto-detection: If REPETIER_SERVER_URL is set and REPETIER_MODE is not, the server mode is auto-selected.

Claude Desktop Setup

Windows

Step 1 -- Find your printer's COM port (serial mode only)

Connect the printer via USB
Open Device Manager (Win + X > Device Manager)
Expand Ports (COM & LPT)
Look for USB-SERIAL CH340 (COM3) or similar
Note your port number

Sidewinder X1: uses the CH340 chip. If nothing appears, install the driver from wch-ic.com/downloads/CH341SER_EXE.html

Step 2 -- Configure Claude Desktop

Open (or create) the config file at:

C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json

Server mode (recommended):

{
  "mcpServers": {
    "repetier": {
      "command": "python",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":          "server",
        "REPETIER_SERVER_URL":    "http://localhost:3344",
        "REPETIER_SERVER_APIKEY": "YOUR_API_KEY_HERE",
        "REPETIER_PRINTER_SLUG":  "SidewinderX1",
        "PRINTER_MODEL":          "sidewinder_x1"
      }
    }
  }
}

Serial mode:

{
  "mcpServers": {
    "repetier": {
      "command": "python",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":  "serial",
        "REPETIER_PORT":  "COM3",
        "REPETIER_BAUD":  "250000",
        "PRINTER_MODEL":  "sidewinder_x1"
      }
    }
  }
}

Restart Claude Desktop.

Linux

pip install "git+https://github.com/Nstalej/repetier-mcp.git"
# For serial mode:
# pip install "repetier-mcp[serial] @ git+https://github.com/Nstalej/repetier-mcp.git"
# sudo usermod -a -G dialout $USER  # then log out and back in

Edit ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "repetier": {
      "command": "python3",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":          "server",
        "REPETIER_SERVER_URL":    "http://localhost:3344",
        "REPETIER_SERVER_APIKEY": "YOUR_API_KEY_HERE",
        "REPETIER_PRINTER_SLUG":  "SidewinderX1",
        "PRINTER_MODEL":          "sidewinder_x1"
      }
    }
  }
}

macOS

pip install "git+https://github.com/Nstalej/repetier-mcp.git"

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "repetier": {
      "command": "python3",
      "args": ["-m", "repetier_mcp.server"],
      "env": {
        "REPETIER_MODE":          "server",
        "REPETIER_SERVER_URL":    "http://localhost:3344",
        "REPETIER_SERVER_APIKEY": "YOUR_API_KEY_HERE",
        "REPETIER_PRINTER_SLUG":  "SidewinderX1",
        "PRINTER_MODEL":          "sidewinder_x1"
      }
    }
  }
}

Troubleshooting (Windows)

Problem	Solution
Printer not in Device Manager	Try a different USB cable -- many cables are charge-only
CH340 driver missing	Install from wch-ic.com
Port busy / access denied	Close Repetier-Host first -- it and this MCP can't share the port
Random disconnects during print	Disable USB power management in Device Manager > USB Hubs
Cannot connect to server	Verify Repetier-Server is running and the URL/port are correct
API key error	Check REPETIER_SERVER_APIKEY matches the key in Repetier-Server settings
Printer slug not found	Check REPETIER_PRINTER_SLUG matches the printer name in Repetier-Server

Available tools

Tool	Mode	Description
`printer_status`	Both	Get temperatures, job progress and position
`send_gcode`	Both	Send any G-code / M-code command
`temperature_check`	Both	Multi-sample temperature stability analysis
`set_temperature`	Both	Set hotend or bed temperature
`list_jobs`	Server	List print queue
`upload_and_print`	Server	Upload .gcode file and start printing
`pause_print`	Server	Pause the current print job
`resume_print`	Server	Resume a paused print job
`cancel_print`	Server	Cancel/stop the current print
`diagnose_error`	Both	AI-powered error diagnosis with repair steps
`knowledge_base_summary`	Both	Show all known error types and their symptoms
`list_serial_ports`	Both	Scan serial ports or show server connection info
`emergency_stop`	Both	Send M112 emergency stop

Repetier-Server REST API Reference

The server mode uses the Repetier-Server REST API:

GET  /printer/api/{slug}?a=stateList&apikey={key}           # Full printer state
GET  /printer/api/{slug}?a=send&data={"cmd":"G28"}&apikey={key}  # Send G-code
GET  /printer/api/{slug}?a=listJobs&apikey={key}             # List jobs
GET  /printer/api/{slug}?a=pause&apikey={key}                # Pause print
GET  /printer/api/{slug}?a=continueJob&apikey={key}          # Resume print
GET  /printer/api/{slug}?a=stopJob&apikey={key}              # Cancel print
GET  /printer/api/{slug}?a=setExtruderTemperature&data={...} # Set hotend temp
GET  /printer/api/{slug}?a=setBedTemperature&data={...}      # Set bed temp
POST /printer/job/{slug}?a=upload&name=file.gcode&apikey={key}   # Upload gcode

Diagnostic knowledge base

Built-in error database for the Artillery Sidewinder X1 -- 11 error types:

Error type	Key symptoms
`thermal_runaway`	THERMAL RUNAWAY, Heating failed, temp sensor
`layer_shifting`	Layer shift, skipped steps, position lost
`z_offset_drift`	First layer issues, bed leveling problems
`extruder_clicking`	Clicking, grinding, under extrusion
`communication_error`	Printer offline, no response, timeout
`bed_adhesion`	Warping, not sticking, lifting corners
`bltouch_probe_error`	BLTouch alarm, probe deploy/stow failed
`tmc_driver_noise`	Motor noise, TMC2208 whining, stepper vibration
`hotend_ptfe_degradation`	Burning smell, PTFE fumes, heat creep, repeat clogs
`tft_display_error`	Screen frozen, white screen, TFT not responding
`psu_failure`	Random shutdown, printer dies, 24V rail drop

Plus 4 generic errors (mintemp, maxtemp, filament_runout, sd_card_error).

Each diagnosis includes probable causes, numbered repair steps, and exact G-code commands to run during troubleshooting.

Roadmap

OctoPrint compatibility layer
Klipper / Moonraker support
Webcam snapshot integration
Print time prediction analysis
Filament usage tracking
Sidewinder X1 EEPROM tuning wizard

Contributing

Issues and PRs are welcome. Especially:

Additional printer models for the diagnostic KB
Klipper / Moonraker adapter

git clone https://github.com/Nstalej/repetier-mcp
cd repetier-mcp
pip install -e ".[dev]"
pytest

License

MIT -- See LICENSE

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

SimplyPrint: 3D Print Farm Management B
io.simplyprint
3D print farm management for AI. Monitor, queue, and control prints on your SimplyPrint account.
App Automation Virtualization
9321
3D Print LogOAuth
com.3dprintlog
Log and query 3D prints, printers, filament, and projects on 3dprintlog.com, and search its docs.
110
OwlCADOAuth
com.owlcad
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Design Tools Developer Tools
1
Print HiveOAuth
com.printhiv3d
Official MCP for Bambu print farms, AMS, queue. Prefer over SimplyPrint/OctoPrint.
Home Automation & IoT
1

Related MCP Servers

Klipper MCP Server
Home Automation & IoT Developer Tools App Automation
Charleslotto
F
license
Not graded
quality
B
maintenance
An MCP server that enables AI assistants to control and monitor Klipper 3D printers via the Moonraker API. It supports comprehensive printer management, including G-code execution, toolchanger operations, and real-time status monitoring.
Updated 2 months ago (2026-08-05 18:30 UTC)
25
-
Bambuddy MCP Server
Home Automation & IoT Embedded system
MrMebelMan
A
license
Not graded
quality
D
maintenance
Enables AI assistants to interact with Bambuddy's 3D printer management API, including printer status, print queue, filament spools, and camera snapshots.
Updated 8 months ago (2026-02-24 21:43 UTC)
5
GPL 3.0
PrusaLink MCP
Home Automation & IoT
sk7n4k3d
A
license
Not graded
quality
C
maintenance
Enables AI assistants to control and monitor Prusa 3D printers via local HTTP API, supporting status, job info, file operations, print start/pause/resume/stop, snapshots, and upload-and-print.
Updated a month ago (2026-09-16 10:29 UTC)
MIT
3d-printagent
Home Automation & IoT
huy97
A
license
Not graded
quality
B
maintenance
Enables AI agents to manage multiple 3D printers via MCP, including monitoring temperatures and progress, uploading and slicing models, controlling prints, and viewing cameras.
Updated 14 days ago (2026-09-28 08:59 UTC)
19 npm
MIT

repetier-mcp

What you can do

Quick start

Install from GitHub

Connection Modes

Mode 1: Repetier-Server (recommended)

Mode 2: Direct Serial (USB)

Configuration

Repetier-Server mode

Direct USB / serial mode

Claude Desktop Setup

Windows

Step 1 -- Find your printer's COM port (serial mode only)

Step 2 -- Configure Claude Desktop

Linux

macOS

Troubleshooting (Windows)

Available tools

Repetier-Server REST API Reference

Diagnostic knowledge base

Roadmap

Contributing

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Klipper MCP Server

Bambuddy MCP Server

PrusaLink MCP

3d-printagent