drucker-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DRUCKER_CHROME | No | Pfad zu Chrome/Chromium. | |
| DRUCKER_AUSGABE | No | Ordner für Vorschauen und PDFs. | ~/.cache/drucker-mcp |
| DRUCKER_ETIKETT | Yes | CUPS-Queue des Etikettendruckers (Pflicht für Etiketten). | |
| DRUCKER_SCHRIFT | No | TTF für Etiketten (Standard: Arial Bold bzw. DejaVu Sans Bold). | |
| DRUCKER_DOKUMENT | No | CUPS-Queue für Dokumente (sonst CUPS-Standarddrucker). | |
| DRUCKER_ETIKETT_URI | No | ipp://host:631/ipp/print, falls die Queue keine ipp/dnssd-Adresse hat. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Druckt über CUPS: Etiketten auf einem Etikettendrucker (z. B. Brother QL) und Dokumente (PDF, Markdown) auf einem normalen Drucker. ⛔ Drucken verbraucht Material und ist nicht rückgängig zu machen: drucke nur auf ausdrücklichen Auftrag. Bei Etiketten zuerst etikett_vorschau aufrufen, die PNG-Datei zeigen bzw. beschreiben, und erst nach Bestätigung etikett_drucken. Die eingelegte Etikettenrolle wird vor jedem Druck vom Drucker gelesen; passt der Auftrag nicht zur Rolle, bricht der Server ab. In Zeilen wird {datum} durch das heutige Datum ersetzt.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| drucker_listeA | Alle CUPS-Drucker mit Status; beim Etikettendrucker zusätzlich die eingelegte Rolle. |
| etikett_rolleA | Liest vom Etikettendrucker, welche Rolle gerade eingelegt ist (Breite, endlos oder vorgestanzt). |
| etikett_vorschauA | 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). |
| etikett_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. |
| datei_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. |
| druckauftraegeA | Offene Druckaufträge aller Drucker (hängende Aufträge z. B. bei ausgeschaltetem Drucker). |
| druckauftrag_abbrechenA | Bricht einen offenen Druckauftrag ab (ID aus druckauftraege, z. B. 'Brother_QL_820NWB-109'). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.