Skip to main content
Glama
drucker-mcp-server

drucker-mcp-server

by Schimmilab

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. roll_current_38x0mm

Höhe = Rollenbreite, Länge ergibt sich aus dem Text (oder laenge_mm)

Vorgestanzt, z. B. …_38x90mm

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

drucker_liste

alle CUPS-Drucker mit Status, beim Etikettendrucker die eingelegte Rolle

etikett_rolle

liest die eingelegte Rolle (Breite, endlos/vorgestanzt)

etikett_vorschau

rendert das Etikett als PNG, ohne zu drucken

etikett_drucken

druckt 1–20 Kopien; Zeilen, Größe, optional feste Länge, QR-Code und Rahmen

datei_drucken

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 bestaetigt=True

druckauftraege

offene Aufträge (z. B. wenn ein Drucker aus ist)

druckauftrag_abbrechen

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-mcp

Die Queue-Namen zeigt lpstat -p.

Variable

Bedeutung

DRUCKER_ETIKETT

CUPS-Queue des Etikettendruckers (Pflicht für Etiketten)

DRUCKER_ETIKETT_URI

ipp://host:631/ipp/print, falls die Queue keine ipp/dnssd-Adresse hat

DRUCKER_DOKUMENT

Queue für Dokumente (sonst CUPS-Standarddrucker)

DRUCKER_AUSGABE

Ordner für Vorschauen und PDFs (Standard ~/.cache/drucker-mcp)

DRUCKER_SCHRIFT

TTF für Etiketten (Standard: Arial Bold bzw. DejaVu Sans Bold)

DRUCKER_CHROME

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 tools
datei_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

druckauftraegeDruckauftraegeA
Read-only

Offene Druckaufträge aller Drucker (hängende Aufträge z. B. bei ausgeschaltetem Drucker).

Inputs: no named parameters. Returns: result

druckauftrag_abbrechenDruckauftrag AbbrechenA
Destructive

Bricht einen offenen Druckauftrag ab (ID aus druckauftraege, z. B. 'Brother_QL_820NWB-109').

Inputs: auftrag (required). Returns: result

drucker_listeDrucker ListeA
Read-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 RolleA
Read-only

Liest vom Etikettendrucker, welche Rolle gerade eingelegt ist (Breite, endlos oder vorgestanzt).

Inputs: no named parameters. Returns: result

etikett_vorschauEtikett VorschauA
Read-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

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      6
      16 npm
      13
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables printing structured documents to ESC/POS thermal printers via a CUPS queue, with tools for printer info, print jobs, and template management.
      1
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables generating print-ready PDFs from Markdown and submitting them to CUPS printers. Supports local, Tailscale, and Cloudflare Tunnel access.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      5
      2
      MIT