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.
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.
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 |
| 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
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.
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 |
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.
MIT
This server cannot be deployed
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.
