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: Klipper 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

mytesla.ioOAuth
io.mytesla
Control your Tesla from your AI assistant - climate, charging, access, and security.
Home Automation & IoT Travel & Transportation
2
GitHubOAuth
io.github.github
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Version Control Developer Tools CI/CD & DevOps
1232,954
MetehanGZL-pokemcpOAuth
ai.smithery
Provide detailed Pokémon data and information through a standardized MCP interface. Enable LLMs an…
Search Open Data
2
hithereiamaliff-mcp-nextcloudOAuth
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
238

Related MCP Servers

MCP 3D Printer Server
App Automation Developer Tools
DMontgomery40
A
license
Not graded
quality
B
maintenance
Enables interaction with 3D printer management systems through an MCP server, supporting STL file manipulation, slicing, and control of printers like OctoPrint, Klipper, Duet, and more.
Updated 2 months ago (2026-07-30 20:57 UTC)
57 npm
236
GPL 2.0
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 a month ago (2026-08-05 18:30 UTC)
23
-
Bambu Lab MCP Server
Home Automation & IoT App Automation
schwarztim
A
license
A
quality
B
maintenance
Enables comprehensive control and monitoring of Bambu Lab 3D printers through Claude using local MQTT, FTPS, and X.509 authentication. Users can manage print jobs, monitor real-time status, handle filament through AMS, and adjust hardware settings like temperature and lighting.
Updated 6 days ago (2026-09-09 22:34 UTC)
24
18 npm
19
MIT
OrcaSlicer MCP Server
Software Architecture Developer Tools App Automation
itsumonotakumi
A
license
A
quality
D
maintenance
Enables AI agents to interact with OrcaSlicer to manage profiles, adjust printing settings, and perform slicing operations. It allows users to search settings, slice STL/3MF files, and analyze G-code metadata through natural language assistants.
Updated 7 months ago (2026-02-08 07:39 UTC)
7
AGPL 3.0

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

MCP 3D Printer Server

Klipper MCP Server

Bambu Lab MCP Server

OrcaSlicer MCP Server