Zhimu Cloud Printing MCP

webprinter_mcp ist ein MCP-Server für Cloud-Druck. Wenn Ihr MCP-Client stdio-basierte MCPs unterstützt, können Sie damit Dateien hochladen, Drucker abfragen, Druckaufträge übermitteln und direkt drucken.

Was kann es für Sie tun?

Sie können es sich als ein „Werkzeug vorstellen, das Ihre Druckaufträge für Sie erledigt“.

Zum Beispiel können Sie zu einer KI, die mit diesem MCP verbunden ist, sagen:

• „Schau mal nach, ob gerade Drucker verfügbar sind.“

• „Lade diese Datei hoch, um sie zum Drucken vorzubereiten.“

• „Füge diese Datei zur Druckwarteschlange hinzu.“

• „Drucke direkt auf dem Drucker im Büro.“

• „Ändere den letzten Auftrag auf beidseitigen Druck.“

Vorbereitung vor der Nutzung

Sie müssen zuerst den Zhimu Cloud-Druckserver installieren und die Druckerfreigabe einrichten. Bitte laden Sie das Installationspaket von Zhimu Cloud Printing herunter:

• https://any.webprinter.cn

Anschließend benötigen Sie ein Cloud-Druck-Zugriffstoken (Token).

Abrufadresse:

• [https://any.webprinter.cn/get-ai-server-token](https://any.webprinter.cn/get-ai-server-token)

Nachdem Sie das Token erhalten haben, setzen Sie die Umgebungsvariable:

• WEBPRINTER_ACCESS_TOKEN: Erforderlich

Installation

Installation via pip

pip install webprinter_mcp

Oder Installation aus dem Quellcode

pip install .

Startvorgang

Wenn Sie nur überprüfen möchten, ob es lokal startet, können Sie Folgendes ausführen:

webprinter_mcp

Oder:

python -m webprinter_mcp

Hinweis: Nach dem Start dieses Befehls werden normalerweise keine aktiven Eingabeaufforderungen angezeigt. Es wechselt in den Wartezustand auf eine Verbindung durch den MCP-Client, was normal ist.

Konfiguration im MCP-Client

Dieses Projekt ist besser für die Einbindung via stdio geeignet.

Lokale Python-Methode

Wenn Sie dieses Paket bereits lokal installiert haben, wird folgende Konfiguration empfohlen:

{
  "type": "stdio",
  "config": {
    "mcpServers": {
      "webprinter": {
        "type": "stdio",
        "command": "webprinter_mcp",
        "args": [],
        "env": {
          "WEBPRINTER_ACCESS_TOKEN": "your-access-token"
        }
      }
    }
  }
}

npx-Methode

Wenn Ihr Client den npx-Stil unterstützt, können Sie auch so konfigurieren:

{
  "type": "stdio",
  "config": {
    "mcpServers": {
      "webprinter": {
        "type": "npx",
        "command": "npx",
        "args": ["-y", "webprinter_mcp"],
        "env": {
          "WEBPRINTER_ACCESS_TOKEN": "your-access-token"
        }
      }
    }
  }
}

Hinweis: Wenn Sie npx webprinter_mcp verwenden, muss auf dem lokalen Rechner dennoch eine Python-Laufzeitumgebung verfügbar sein.

Empfehlung für den ersten Test

Bei der ersten Verwendung wird empfohlen, Schritt für Schritt vorzugehen:

Zuerst prüfen, ob das aktuelle Konto die Voraussetzungen für Cloud-Druck erfüllt

Sie können es so verstehen:

• „Prüfe zuerst, ob die aktuelle Umgebung Cloud-Druck normal nutzen kann.“

Wenn die Rückmeldung anzeigt, dass der Client oder das Gerät noch nicht bereit ist, schließen Sie zuerst die Installation und Konfiguration der Freigabe auf der WebPrinter-Seite ab.

Dann die verfügbaren Drucker auflisten lassen

Sie können sagen:

• „Zeig mir, welche Drucker aktuell verfügbar sind.“

Dieser Schritt liefert normalerweise:

• Druckernamen

• Drucker-Alias

• Online-Status

• ID des Steuergeräts

Wenn Sie eine lokale Datei haben, laden Sie diese zuerst hoch

Sie können es so verstehen:

• „Lade diese lokale PDF-Datei hoch und gib mir eine druckbare Adresse.“

Bei der lokalen Fehlersuche sehen die Parameter normalerweise so aus:

{
  "file_path": "C:\\\\docs\\\\report.pdf"
}

Dann entscheiden Sie zwischen „Roaming-Druck“ oder „Direktdruck“

Wenn Sie nur die Druckwarteschlange nutzen möchten, können Sie sagen:

• „Reiche diese Datei zum Roaming-Druck ein.“ oder

• „Füge diese Datei zur Druckwarteschlange hinzu.“

Wenn Sie sofort auf einem bestimmten Drucker drucken möchten, können Sie sagen:

• „Drucke diese Datei direkt auf dem HP-Drucker im Büro.“

Umgangssprachliche Anwendungsbeispiele

Die folgenden Formulierungen sind für dieses MCP besonders gut geeignet:

• „Prüfe, ob die aktuelle Cloud-Druckumgebung funktioniert.“

• „Zeig mir, welche Drucker verfügbar sind.“

• „Lade die PDF-Datei auf meinem Desktop hoch.“

• „Füge diese Webseite zur Druckwarteschlange hinzu.“

• „Drucke direkt auf dem Drucker am Empfang.“

• „Ändere den letzten Auftrag auf beidseitigen Druck.“

Häufig gestellte Fragen

Warum passiert nichts, wenn ich webprinter_mcp ausführe?

Das ist normal. Nach dem Start wartet es kontinuierlich auf eine Verbindung des MCP-Clients über stdio und gibt nicht sofort viele Informationen aus wie herkömmliche Befehlszeilentools.

Was tun bei Token-Fehlern beim Start?

Bitte holen Sie sich zuerst hier ein Token:

• [https://get-ai-token.webprinter.cn](https://any.webprinter.cn/get-ai-server-token)

Stellen Sie dann sicher, dass Sie Folgendes gesetzt haben:

• WEBPRINTER_ACCESS_TOKEN

Der Befehl ist installiert, aber webprinter_mcp wird nicht gefunden

Normalerweise ist das Scripts-Verzeichnis von Python noch nicht im PATH enthalten. In diesem Fall können Sie es direkt verwenden:

python -m webprinter_mcp

Werkzeuge zur Aufgabenkonfiguration

Für bereits erstellte Roaming-Druckaufträge können Sie nun folgende Konfigurationen anpassen:

• update_printer_side(task_id, side)

• update_printer_color(task_id, color)

• update_printer_copies(task_id, copies)

• update_printer_paper(task_id, paper)

Parameterbeschreibung

• task_id

  • ID des Roaming-Druckauftrags

• side

  • Mögliche Werte: ONESIDE, DUPLEX, TUMBLE

  • Bedeutung: Einseitig, beidseitig lange Kante, beidseitig kurze Kante

• color

  • Mögliche Werte: COLOR, MONOCHROME

  • Bedeutung: Farbe, Schwarz-Weiß

• copies

  • Ganzzahl

  • Muss größer oder gleich 1 sein

• paper

  • Sie können direkt den Namen des Papiertyps übergeben, z. B. A3, A4, A5, LETTER

  • Sie können auch ein benutzerdefiniertes Objekt übergeben: {"width": 210, "height": 297}

  • Die Einheiten für Breite und Höhe sind Millimeter

Anwendungsbeispiele

Wenn Sie dies über natürliche Sprache in einem MCP-Client aufrufen, können Sie sagen:

• „Ändere Auftrag 123 auf beidseitigen Druck.“

• „Ändere Auftrag 123 auf Schwarz-Weiß-Druck.“

• „Ändere Auftrag 123 auf 3 Kopien.“

• „Ändere Auftrag 123 auf A4-Papier.“

• „Ändere Auftrag 123 auf Papier mit 210 mm Breite und 297 mm Höhe.“

Wenn Sie dies lokal in der CLI debuggen, können Sie es so verwenden:

python scripts/mcp_client.py update-printer-side --task-id 123 --side DUPLEX
python scripts/mcp_client.py update-printer-color --task-id 123 --color MONOCHROME
python scripts/mcp_client.py update-printer-copies --task-id 123 --copies 3
python scripts/mcp_client.py update-printer-paper --task-id 123 --paper A4
python scripts/mcp_client.py update-printer-paper --task-id 123 --width 210 --height 297