drucker-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@drucker-mcp-server Druck mir ein Etikett Salz-Dillgurken mit Datum"
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.
drucker-mcp-server
MCP-Server für CUPS-Drucker. Er druckt Etiketten passend zur eingelegten Rolle (getestet mit Brother QL-820NWB) und Dokumente (PDF, Markdown, HTML) auf einem normalen Drucker. Ein Satz wie „Druck mir ein Etikett Salz-Dillgurken mit Datum“ reicht.
Vor jedem Etikettendruck fragt der Server den Drucker per IPP, welche Rolle eingelegt ist, und baut das Layout danach:
Rolle (Drucker meldet) | Layout |
Endlos, z. B. | Höhe = Rollenbreite, Länge ergibt sich aus dem Text (oder |
Vorgestanzt, z. B. | feste Größe; ein Auftrag mit anderer Länge wird nicht gedruckt |
Die Schriftgröße wählt man über groesse: klein (~4 mm), mittel (~7 mm, Standard) oder gross (füllt die Rollenbreite). Auf einer Endlosrolle legt sie damit auch die Länge fest. Mit laenge_mm gibt man stattdessen eine feste Länge vor, die Schrift passt sich dann an. Mit quer=true läuft der Text quer zur Rolle; laenge_mm ist dann die Höhe des Etiketts. So entstehen kurze Etiketten wie 25 × 38 mm für schmale Klebeflächen (z. B. Steckdosen), ohne Nachschneiden. Ein QR-Code wächst mit dem Text, ist aber nie kleiner als 15 mm. In jeder Zeile wird {datum} durch das heutige Datum ersetzt.
Werkzeuge
Tool | Wirkung |
| alle CUPS-Drucker mit Status, beim Etikettendrucker die eingelegte Rolle |
| liest die eingelegte Rolle (Breite, endlos/vorgestanzt) |
| rendert das Etikett als PNG, ohne zu drucken |
| druckt 1–20 Kopien; Zeilen, Größe, optional feste Länge, QR-Code und Rahmen |
| PDF/Markdown/HTML, Farbe oder SW, Duplex, Seitenbereich, Kopien; Markdown/HTML wird per Chrome headless zu A4-PDF. Über 20 Druckseiten (Seiten × Kopien) nur mit |
| offene Aufträge (z. B. wenn ein Drucker aus ist) |
| offenen Auftrag abbrechen |
Die Server-Anweisung verlangt: Drucken nur auf ausdrücklichen Auftrag, bei Etiketten zuerst die Vorschau.
Related MCP server: print-blocks
Voraussetzungen
CUPS mit eingerichteten Druckern (
lp,lpstat,cancel). Unter macOS ist das eingebaut.Etikettendrucker mit IPP (Brother QL-8xxNWB und die meisten Netzwerk-Etikettendrucker). Ist die CUPS-Queue eine Bonjour-Adresse (
dnssd://…), löst der Server sie selbst auf.Für Markdown/HTML: Google Chrome oder Chromium.
Betrieb
uv sync
uv run pytest # Tests, darunter Muss-rot-Fälle (falsche Rolle, unlesbares Medium, Collection-Parsing)
claude mcp add drucker -s user \
-e DRUCKER_ETIKETT=Brother_QL_820NWB \
-e DRUCKER_DOKUMENT=HP_Color_LaserJet_Pro_MFP_3302 \
-- uv run --directory <pfad> drucker-mcpDie Queue-Namen zeigt lpstat -p.
Variable | Bedeutung |
| CUPS-Queue des Etikettendruckers (Pflicht für Etiketten) |
|
|
| Queue für Dokumente (sonst CUPS-Standarddrucker) |
| Ordner für Vorschauen und PDFs (Standard |
| TTF für Etiketten (Standard: Arial Bold bzw. DejaVu Sans Bold) |
| Pfad zu Chrome/Chromium |
Warum IPP und nicht der Brother-Rasterstatus
Der Brother-Rasterbefehl ESC i S über Port 9100 bleibt im Netzwerkbetrieb stumm. Auch CUPS liefert media-ready für eine Bonjour-Queue nicht. Der Drucker selbst beantwortet Get-Printer-Attributes aber sauber (media-ready, media-col-ready). Der Server spricht das mit einem kleinen IPP-Client in reinem Python, ohne ipptool.
Kein Docker-Image: Der Server braucht das CUPS des Hosts.
Lizenz
MIT
Available Tools
7 toolsdatei_druckenDatei DruckenA
Druckt PDF, Markdown (.md) oder HTML – nur auf ausdrücklichen Auftrag.
Markdown/HTML wird vorher per Chrome headless zu einem A4-PDF. farbe=False druckt schwarz-weiß. seiten z. B. '1-3,5'. drucker leer = DRUCKER_DOKUMENT bzw. CUPS-Standard. Mehr als 20 Druckseiten (Seiten × Kopien) nur mit bestaetigt=True – vorher den Nutzer fragen.
Inputs: pfad (required), farbe, duplex, kopien, +3 more. Returns: result
druckauftraegeDruckauftraegeARead-only
Offene Druckaufträge aller Drucker (hängende Aufträge z. B. bei ausgeschaltetem Drucker).
Inputs: no named parameters. Returns: result
druckauftrag_abbrechenDruckauftrag AbbrechenADestructive
Bricht einen offenen Druckauftrag ab (ID aus druckauftraege, z. B. 'Brother_QL_820NWB-109').
Inputs: auftrag (required). Returns: result
drucker_listeDrucker ListeARead-only
Alle CUPS-Drucker mit Status; beim Etikettendrucker zusätzlich die eingelegte Rolle.
Inputs: no named parameters. Returns: result
etikett_druckenEtikett DruckenA
Druckt ein Etikett auf dem Etikettendrucker – nur auf ausdrücklichen Auftrag, vorher etikett_vorschau.
Gleiche Parameter wie etikett_vorschau, dazu kopien (1–20). Die Rolle wird vor dem Druck gelesen.
Inputs: zeilen (required), qr, quer, kopien, +3 more. Returns: result
etikett_rolleEtikett RolleARead-only
Liest vom Etikettendrucker, welche Rolle gerade eingelegt ist (Breite, endlos oder vorgestanzt).
Inputs: no named parameters. Returns: result
etikett_vorschauEtikett VorschauARead-only
Rendert ein Etikett passend zur eingelegten Rolle als PNG, OHNE zu drucken.
zeilen: 1–6 Textzeilen. {datum} = heute. groesse: Schrift-Obergrenze 'klein' (~4 mm), 'mittel' (~7 mm, Standard) oder 'gross' (füllt die Rollenbreite). Auf Endlosrollen bestimmt sie damit auch die Länge des Etiketts. laenge_mm: feste Länge, nur bei Endlosrolle; die Schrift wird dann so groß wie hineinpasst. quer: Text quer zur Rolle, für kurze Etiketten, die quer aufgeklebt werden. laenge_mm ist dann die Etikett-Höhe (z. B. 25 → 25 × 38 mm auf der 38-mm-Rolle), kein Abschneiden nötig. qr: optionaler Inhalt für einen QR-Code links (z. B. eine URL).
Inputs: zeilen (required), qr, quer, rahmen, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Print actions (etikett_drucken, datei_drucken), read operations (drucker_liste, etikett_rolle, druckauftraege) and cancellation are clearly separable, and etikett_vorschau vs. etikett_drucken is explicitly contrasted in the descriptions. The only real overlap is drucker_liste vs. etikett_rolle, since the printer list also reports the loaded roll, but the descriptions make the distinction (detailed roll info) workable.
All names are German snake_case with an object-first pattern: query tools use noun compounds (drucker_liste, etikett_rolle, etikett_vorschau, druckauftraege) and action tools use noun_verb (etikett_drucken, datei_drucken, druckauftrag_abbrechen). This is a coherent and readable convention with only a minor split between noun-only and verb-suffixed forms.
Seven tools is well-scoped for a CUPS printer server: discover printers/rolls, preview, print labels, print documents, inspect and cancel jobs. Each tool maps to a distinct step in the printing workflow and none appears redundant.
The surface covers the full practical workflow: enumerate printers, detect label media, preview, print (label + document), list and cancel jobs. Minor gaps remain—no way to inspect a single job's detail/progress or to pause/resume a printer, but agents can work around this via druckauftraege and druckauftrag_abbrechen.
Maintenance
Related MCP Connectors
Render Markdown and LLM output into accessible PDF/UA-1 PDFs. No headless Chromium.
Thermal label MCP server: render, validate, debug and convert ZPL, EPL, TSPL and CPCL labels.
Compliant PDFs (PDF/A-2A + PDF/UA-1) from markdown or a compact DSL - fast, no headless browser.
Render HTML, URLs, and templates to PDF. AI drafts templates and fixes them from logs.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to print documents, manage print queues, and control printers on macOS/Linux systems via the CUPS printing system. Supports printing PDFs, text files, and other formats with options like duplex printing, landscape orientation, and multiple copies.616 npm13MIT
- FlicenseNot gradedqualityDmaintenanceEnables printing structured documents to ESC/POS thermal printers via a CUPS queue, with tools for printer info, print jobs, and template management.1-
- FlicenseNot gradedqualityCmaintenanceEnables generating print-ready PDFs from Markdown and submitting them to CUPS printers. Supports local, Tailscale, and Cloudflare Tunnel access.-
- AlicenseAqualityDmaintenanceEnables printing PNG labels to a nearby thermal label printer over local serial or Bluetooth, with tools for rendering previews, checking printer status, and printing with confirmation.52MIT