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

Sie können zum Beispiel 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 für den Druck vorzubereiten.“

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

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

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

Related MCP server: printagent

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 .

Startmethode

Wenn Sie nur prü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 Zustand, in dem es auf die Verbindung eines MCP-Clients wartet; dies ist normal.

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 ihn 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 funktionierende Python-Umgebung vorhanden sein.

Direkte Verwendung der mcpServers-Konfiguration

Wenn Ihr MCP-Client die mcpServers-Struktur direkt akzeptiert, können Sie auch die folgende Konfiguration verwenden:

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

Dabei gilt:

• WEBPRINTER_ACCESS_TOKEN

  • Muss zuerst von https://any.webprinter.cn/get-ai-server-token abgerufen werden.

• command und args

  • Geben an, dass der MCP-Server über npx webprinter_mcp gestartet wird.

• type

  • Gibt an, dass der aktuelle Client die npx-Methode zur Einbindung verwendet.

Werkzeugliste

Der aktuelle MCP-Server bietet folgende Werkzeuge:

• check_install_progress

  • Überprüft, ob das aktuelle Konto und die Geräteumgebung über Cloud-Druckfunktionen verfügen.

• query_printers

  • Fragt die Liste der für das aktuelle Konto verfügbaren Drucker ab.

• query_printer_detail

  • Fragt detaillierte Funktionsinformationen eines bestimmten Druckers oder freigegebenen Geräts ab.

• upload_file

  • Lädt eine lokale Datei hoch und gibt eine öffentliche URL zurück, die zum Drucken verwendet werden kann.

• create_roaming_task

  • Erstellt einen Roaming-Druckauftrag basierend auf einer Datei-URL.

• update_printer_side

  • Ändert die Duplex/Simplex-Einstellung eines Roaming-Druckauftrags.

• update_printer_color

  • Ändert die Farbe/Schwarz-Weiß-Einstellung eines Roaming-Druckauftrags.

• update_printer_copies

  • Ändert die Anzahl der Kopien eines Roaming-Druckauftrags.

• update_printer_paper

  • Ändert das Papierformat eines Roaming-Druckauftrags; unterstützt voreingestellte Formate wie A3, A4 sowie benutzerdefinierte Breiten und Höhen.

• direct_print_document

  • Sendet eine Datei direkt an einen bestimmten Drucker zum Drucken.

Sie können dies auch als einen vollständigen Druckprozess verstehen:

1. Umgebung prüfen: check_install_progress

2. Drucker anzeigen: query_printers / query_printer_detail

3. Datei hochladen: upload_file

4. Roaming-Druck erstellen: create_roaming_task

5. Auftragsparameter nach Bedarf anpassen: update_printer_side / update_printer_color / update_printer_copies / update_printer_paper

6. Oder direkt drucken: direct_print_document

Werkzeugbeschreibung

Im Folgenden werden die Werkzeuge nach „Zweck, Verhalten, Schlüsselparameter, Nutzungsempfehlung“ beschrieben, um die Darstellung auf MCP-Plattformen, Verzeichnisseiten und in Integrationsdokumenten zu erleichtern.

check_install_progress

• Zweck

  • Überprüft, ob das aktuelle Konto, der Client und die Druckumgebung über verfügbare Cloud-Druckfunktionen verfügen.

• Wann zu verwenden

  • Bei der ersten Einbindung.

  • Wenn Probleme beim Drucken auftreten, Drucker nicht gefunden werden oder die Auftragsübermittlung fehlschlägt.

• Verhalten

  • Fragt den aktuellen Installations- und Konfigurationsstatus bei der Cloud-Druckplattform ab.

  • Ändert keine Druckaufträge.

• Parameter

  • Keine

• Rückgabeergebnis

  • Gibt das Ergebnis der Umgebungsprüfung zurück, das normalerweise verwendet werden kann, um festzustellen, ob die Client-, Geräte- oder Freigabekonfiguration abgeschlossen ist.

• Nutzungsempfehlung

  • Empfohlen als erster Schritt für alle Druckprozesse.

• Beispielanfrage

  • „Prüfe zuerst, ob die Cloud-Druckfunktion in der aktuellen Umgebung funktioniert.“

query_printers

• Zweck

  • Fragt die Liste der für das aktuelle Konto verfügbaren Drucker ab.

• Wann zu verwenden

  • Wenn der Benutzer verfügbare Drucker sehen möchte.

  • Um vor dem direkten Drucken zu bestätigen, ob der Zieldrucker existiert.

• Verhalten

  • Gibt eine Liste der Drucker zurück.

  • Versteckte Drucker werden als „nur für Roaming-Druckaufträge unterstützt“ markiert.

• Parameter

  • Keine

• Rückgabeergebnis

  • Zu den gängigen Feldern gehören Druckername, Alias, Online-Status, Steuerungs-ID, ob versteckt usw.

• Nutzungsempfehlung

  • Wenn der Benutzer sagt „Drucke auf einem bestimmten Drucker“, wird empfohlen, dieses Werkzeug zuerst zu verwenden, um den Gerätenamen und die Steuerungs-ID zu bestätigen.

• Beispielanfrage

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

query_printer_detail

• Zweck

  • Fragt detaillierte Funktionsinformationen eines bestimmten Druckers oder freigegebenen Geräts ab.

• Wann zu verwenden

  • Wenn der Benutzer bestätigen muss, welche Funktionen das Gerät unterstützt.

  • Um vor dem Drucken den Gerätetyp, die Freigabe-ID oder detaillierte Parameter zu bestätigen.

• Verhalten

  • Gibt detaillierte Informationen basierend auf Druckername, Freigabe-ID oder Gerätetyp zurück.

• Parameter

  • printer_name (Druckername, optional)

  • share_sn (Freigabe-ID, optional)

  • device_type (Gerätetyp, optional, unterstützt printer, scanner, camera)

• Rückgabeergebnis

  • Gibt detaillierte Funktionen oder Konfigurationsdaten des angegebenen Geräts zurück.

• Nutzungsempfehlung

  • Geben Sie mindestens ein Filterkriterium an, um den Suchbereich nicht zu groß zu machen.

• Beispielanfrage

  • „Schau mal nach, welche Funktionen der Drucker am Empfang unterstützt.“

upload_file

• Zweck

  • Lädt eine lokale Datei hoch und tauscht sie gegen eine öffentliche URL aus, die für nachfolgende Druckvorgänge verwendet werden kann.

• Wann zu verwenden

  • Wenn sich die Quelldatei auf der lokalen Festplatte befindet.

  • Wenn vor dem Roaming-Druck oder direkten Druck noch keine öffentliche Datei-URL vorhanden ist.

• Verhalten

  • Liest die lokale Datei und lädt sie in die Cloud hoch.

  • Gibt eine Dateiadresse zurück, die vom Druckdienst gelesen werden kann.

• Parameter

  • file_path (Lokaler Dateipfad, erforderlich)

• Rückgabeergebnis

  • Gibt Informationen zur hochgeladenen Datei und die zugängliche Adresse zurück.

• Nutzungsempfehlung

  • Wenn die Datei bereits eine öffentliche URL hat, kann dieser Schritt übersprungen werden.

• Beispielanfrage

  • „Lade das PDF auf meinem Desktop hoch und gib mir eine druckbare Adresse.“

create_roaming_task

• Zweck

  • Erstellt einen Roaming-Druckauftrag, damit die Datei in die Druckwarteschlange gelangt und auf die weitere Verarbeitung wartet.

• Wann zu verwenden

  • Wenn der Benutzer zuerst einen Druckauftrag generieren möchte, anstatt sofort auf einem bestimmten Gerät zu drucken.

• Verhalten

  • Erstellt einen Roaming-Druckauftrag basierend auf Dateiname, Datei-URL und Dateityp.

  • Gibt nach Erfolg die Auftrags-ID zurück.

• Parameter

  • file_name (Anzeigename der Datei, erforderlich)

  • url (Öffentliche Dateiadresse, erforderlich)

  • media_format (Dateiformat, erforderlich, unterstützt PDF, PNG, JPG, WORD, EXCEL, PPT usw.)

• Rückgabeergebnis

  • Gibt die ID des neu erstellten Roaming-Auftrags zurück.

• Nutzungsempfehlung

  • Wenn Sie später Duplex, Farbe, Anzahl der Kopien oder Papier ändern möchten, benötigen Sie diese Auftrags-ID.

• Beispielanfrage

  • „Reiche diese Datei als Roaming-Druckauftrag ein.“

update_printer_side

• Zweck

  • Ändert die Duplex/Simplex-Einstellung eines Roaming-Druckauftrags.

• Wann zu verwenden

  • Wenn der Benutzer explizit Simplex, Duplex, Wenden an der langen Kante oder Wenden an der kurzen Kante angibt.

• Verhalten

  • Aktualisiert die Druckseiteneinstellung des Auftrags basierend auf der Auftrags-ID.

• Parameter

  • task_id (Roaming-Auftrags-ID, erforderlich)

  • side (Optionale Werte: ONESIDE, DUPLEX, TUMBLE)

• Rückgabeergebnis

  • Gibt das Aktualisierungsergebnis zurück.

• Nutzungsempfehlung

  • Gilt für bereits erstellte Roaming-Aufträge, nicht für direkte Druckaufträge.

• Beispielanfrage

  • „Ändere Auftrag 123 auf beidseitigen Druck.“

update_printer_color

• Zweck

  • Ändert den Farbmodus eines Roaming-Druckauftrags.

• Wann zu verwenden

  • Wenn der Benutzer explizit Farb-, Schwarz-Weiß- oder Graustufendruck angibt.

• Verhalten

  • Aktualisiert den Farbmodus basierend auf der Auftrags-ID.

• Parameter

  • task_id (Roaming-Auftrags-ID, erforderlich)

  • color (Optionale Werte: COLOR, MONOCHROME)

• Rückgabeergebnis

  • Gibt das Aktualisierungsergebnis zurück.

• Nutzungsempfehlung

  • Wenn der Benutzer „Schwarz-Weiß-Druck“ sagt, sollte dies in MONOCHROME umgewandelt werden.

• Beispielanfrage

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

update_printer_copies

• Zweck

  • Ändert die Anzahl der Kopien eines Roaming-Druckauftrags.

• Wann zu verwenden

  • Wenn der Benutzer „2 Kopien drucken“ oder „3 Kopien drucken“ sagt.

• Verhalten

  • Aktualisiert die Anzahl der Kopien basierend auf der Auftrags-ID.

• Parameter

  • task_id (Roaming-Auftrags-ID, erforderlich)

  • copies (Anzahl der Kopien, erforderlich, muss größer oder gleich 1 sein)

• Rückgabeergebnis

  • Gibt das Aktualisierungsergebnis zurück.

• Nutzungsempfehlung

  • Wenn der Benutzer die Anzahl nicht explizit nennt, ändern Sie diese nicht eigenmächtig.

• Beispielanfrage

  • „Ändere Auftrag 123 auf 3 Kopien.“

update_printer_paper

• Zweck

  • Ändert das Papierformat eines Roaming-Druckauftrags.

• Wann zu verwenden

  • Wenn der Benutzer Papierformate wie A3, A4, A5, Letter usw. nennt.

  • Wenn der Benutzer direkt Breite und Höhe angibt.

• Verhalten

  • Unterstützt die automatische Umwandlung von Standard-Papiernamen in Millimeter-Breite und -Höhe.

  • Unterstützt auch die direkte Übergabe von benutzerdefinierten width und height.

• Parameter

  • task_id (Roaming-Auftrags-ID, erforderlich)

  • paper (Kann Papiernamen wie A4 oder ein Objekt wie {"width": 210, "height": 297} enthalten)

• Rückgabeergebnis

  • Gibt das Aktualisierungsergebnis zurück.

• Nutzungsempfehlung

  • Die Einheit für Breite und Höhe ist Millimeter.

  • Aktuell unterstützte Voreinstellungen umfassen A0-A6, B4, B5, LETTER, LEGAL, TABLOID.

• Beispielanfrage

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

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

direct_print_document

• Zweck

  • Sendet eine Datei direkt an einen bestimmten Drucker.

• Wann zu verwenden

  • Wenn der Benutzer explizit angibt, dass sofort auf einem bestimmten Drucker gedruckt werden soll.

• Verhalten

  • Initiiert den Druck direkt basierend auf Dateiinformationen und Zielgerätinformationen.

  • Wenn der Zieldrucker ein versteckter Drucker ist, wird der direkte Druck verhindert und der Benutzer aufgefordert, stattdessen einen Roaming-Auftrag zu verwenden.

• Parameter

  • file_name (Anzeigename der Datei, erforderlich)

  • url (Öffentliche Dateiadresse, erforderlich)

  • media_format (Dateiformat, erforderlich)

  • device_name (Zieldruckername, erforderlich)

  • control_sn (Steuerungs-ID des Zieldruckers, erforderlich)

• Rückgabeergebnis

  • Gibt das Ergebnis des direkten Drucks zurück.

• Nutzungsempfehlung

  • Es wird empfohlen, zuerst query_printers aufzurufen, um den Zieldruckernamen und die Steuerungs-ID zu bestätigen.

  • Bei einer lokalen Datei zuerst upload_file aufrufen.

• Beispielanfrage

  • „Drucke diese Datei direkt auf dem Drucker am Empfang.“

Empfehlung für den ersten Test

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

Prüfen Sie zuerst, ob das aktuelle Konto die Voraussetzungen für Cloud-Druck erfüllt

Sie können es so verstehen:

• „Prüfe zuerst für mich, ob die Cloud-Druckfunktion in der aktuellen Umgebung normal funktioniert.“

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

Lassen Sie sich dann die aktuell verfügbaren Drucker auflisten

Sie können so sagen:

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

In diesem Schritt erhalten Sie normalerweise:

• Druckername

• Drucker-Alias

• Online-Status

• Steuerungs-ID

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

Sie können es so verstehen:

• „Lade dieses PDF von meinem lokalen Rechner hoch und gib mir eine druckbare Adresse.“

Bei der lokalen Fehlersuche sehen die gängigen Parameter so aus:

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

Entscheiden Sie dann zwischen „Roaming-Druck“ oder „Direktem Druck“

Wenn Sie nur zuerst in die Druckwarteschlange gelangen möchten, können Sie es so verstehen:

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

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

Wenn Sie sofort auf einem bestimmten Drucker drucken möchten, können Sie es so verstehen:

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

Umgangssprachlichere Anwendungsbeispiele

Die folgenden Aussagen sind für diesen MCP gut geeignet:

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

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

• „Lade das PDF 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, nachdem ich webprinter_mcp ausgeführt habe?

Das ist normal. Nach dem Start wartet es kontinuierlich auf die Verbindung des MCP-Clients über stdio und druckt nicht sofort viele Informationen wie ein normales Befehlszeilenwerkzeug.

Was tun, wenn beim Start ein Token-Fehler auftritt?

Bitte holen Sie sich zuerst hier ein Token:

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

Bestätigen Sie dann, 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 Auftragskonfiguration

Für bereits erstellte Roaming-Druckaufträge können Sie nun folgende Konfigurationen weiter 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

  • Roaming-Druckauftrags-ID

• side

  • Optionale Werte: ONESIDE, DUPLEX, TUMBLE

  • Bedeuten jeweils: Simplex, Duplex (Wenden an der langen Kante), Duplex (Wenden an der kurzen Kante)

• color

  • Optionale Werte: COLOR, MONOCHROME

  • Bedeuten jeweils: Farbe, Schwarz-Weiß

• copies

  • Ganzzahl

  • Muss größer oder gleich 1 sein

• paper

  • Kann direkt den Papiernamen übergeben, z. B. A3, A4, A5, LETTER

  • Kann auch ein benutzerdefiniertes Objekt übergeben: {"width": 210, "height": 297}

  • Die Einheit für Breite und Höhe ist Millimeter

Anwendungsbeispiele

Wenn Sie im MCP-Client über natürliche Sprache aufrufen, können Sie so 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 im lokalen 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