Skip to main content
Glama
drucker-mcp-server

drucker-mcp-server

by Schimmilab

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DRUCKER_CHROMENoPfad zu Chrome/Chromium.
DRUCKER_AUSGABENoOrdner für Vorschauen und PDFs.~/.cache/drucker-mcp
DRUCKER_ETIKETTYesCUPS-Queue des Etikettendruckers (Pflicht für Etiketten).
DRUCKER_SCHRIFTNoTTF für Etiketten (Standard: Arial Bold bzw. DejaVu Sans Bold).
DRUCKER_DOKUMENTNoCUPS-Queue für Dokumente (sonst CUPS-Standarddrucker).
DRUCKER_ETIKETT_URINoipp://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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.9/5.0

Scored across 7 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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

ActivityMaintained
ResponsivenessNo recent community issues