智睦云打印
OfficialZhimu 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: Memobird MCP Server
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_mcpOder 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_mcpOder:
python -m webprinter_mcpHinweis: 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_TOKENMuss zuerst von
https://any.webprinter.cn/get-ai-server-tokenabgerufen werden.
commandundargsGeben an, dass der MCP-Server über
npx webprinter_mcpgestartet wird.
typeGibt 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_printersFragt die Liste der für das aktuelle Konto verfügbaren Drucker ab.
query_printer_detailFragt detaillierte Funktionsinformationen eines bestimmten Druckers oder freigegebenen Geräts ab.
upload_fileLädt eine lokale Datei hoch und gibt eine öffentliche URL zurück, die zum Drucken verwendet werden kann.
create_roaming_taskErstellt 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,A4sowie benutzerdefinierte Breiten und Höhen.
direct_print_documentSendet eine Datei direkt an einen bestimmten Drucker zum Drucken.
Sie können dies auch als einen vollständigen Druckprozess verstehen:
Umgebung prüfen:
check_install_progressDrucker anzeigen:
query_printers/query_printer_detailDatei hochladen:
upload_fileRoaming-Druck erstellen:
create_roaming_taskAuftragsparameter nach Bedarf anpassen:
update_printer_side/update_printer_color/update_printer_copies/update_printer_paperOder 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ütztprinter,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ütztPDF,PNG,JPG,WORD,EXCEL,PPTusw.)
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
MONOCHROMEumgewandelt 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 gleich1sein)
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
widthundheight.
Parameter
task_id(Roaming-Auftrags-ID, erforderlich)paper(Kann Papiernamen wieA4oder 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_printersaufzurufen, um den Zieldruckernamen und die Steuerungs-ID zu bestätigen.Bei einer lokalen Datei zuerst
upload_fileaufrufen.
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_mcpWerkzeuge 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_idRoaming-Druckauftrags-ID
sideOptionale Werte:
ONESIDE,DUPLEX,TUMBLEBedeuten jeweils: Simplex, Duplex (Wenden an der langen Kante), Duplex (Wenden an der kurzen Kante)
colorOptionale Werte:
COLOR,MONOCHROMEBedeuten jeweils: Farbe, Schwarz-Weiß
copiesGanzzahl
Muss größer oder gleich
1sein
paperKann direkt den Papiernamen übergeben, z. B.
A3,A4,A5,LETTERKann 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
123auf beidseitigen Druck.“„Ändere Auftrag
123auf Schwarz-Weiß-Druck.“„Ändere Auftrag
123auf 3 Kopien.“„Ändere Auftrag
123auf A4-Papier.“„Ändere Auftrag
123auf 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 297Available Tools
10 toolscheck_install_progressB
Check whether the user's cloud print environment is fully configured.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. While it implies a status check ('whether...fully configured'), it fails to specify the return format (boolean, percentage, list of missing components), caching behavior, or what criteria define 'fully configured.'
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence of nine words with no redundant information. It is appropriately front-loaded with the action verb and wastes no space on tautological restatements of the tool name.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero parameters and no output schema, the description is minimally adequate for tool selection but leaves significant gaps. It does not explain what constitutes 'fully configured,' what the response structure looks like, or how this relates to the sibling printer management tools, which would be valuable given the lack of structured metadata.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has zero parameters, which per the scoring rules establishes a baseline of 4. There are no parameters requiring semantic explanation beyond what the schema (empty properties object) already conveys.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses the specific verb 'Check' and identifies the resource 'user's cloud print environment' with the scope 'fully configured.' It distinguishes from siblings like query_printers (which lists specific printers) by focusing on overall environment configuration status rather than individual device queries.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description states what the tool does but provides no guidance on when to use it versus alternatives. It does not indicate whether this should be called before other operations, how it relates to query_printers, or prerequisites for invocation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_roaming_taskC
Create a roaming print task from a public document URL.
| Name | Required | Description | Default |
|---|---|---|---|
| file_name | Yes | ||
| url | Yes | ||
| media_format | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It adds the constraint that the URL must be 'public,' but fails to disclose whether the operation is asynchronous, what the return value is (likely a task ID given the 'create task' naming), or how to check task status. It does not indicate if the operation is destructive or idempotent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single efficient sentence with no redundancy. However, given that all three parameters lack schema descriptions and no annotations exist, the description is underspecified. It prioritizes brevity over necessary detail, making it 'too concise' for the complexity of the tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a mutation tool with three undocumented parameters, no annotations, and no output schema, the description is insufficient. It lacks guidance on the 'roaming' workflow, expected 'media_format' values, the purpose of 'file_name' when a URL is provided, and how to interpret or use the return value (presumably a task identifier).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 0% description coverage for all three parameters (file_name, url, media_format). The description only partially compensates by implying the 'url' parameter requires a public document URL. It completely omits explanation of 'file_name' (is it a destination name or metadata?) and 'media_format' (expected values like 'A4', 'Letter', 'PDF'?).
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Create') and resource ('roaming print task'), and includes the source ('public document URL'). The term 'roaming' helps distinguish it from the sibling 'direct_print_document', though it could further clarify what 'roaming' implies in this context.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus siblings like 'direct_print_document' or 'upload_file'. It mentions 'public document URL' which hints at a requirement, but does not explicitly state selection criteria or prerequisites for using this specific tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
direct_print_documentC
Send a document directly to a specific printer.
| Name | Required | Description | Default |
|---|---|---|---|
| file_name | Yes | ||
| url | Yes | ||
| media_format | Yes | ||
| device_name | Yes | ||
| control_sn | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description adds zero behavioral context. It does not disclose whether the operation is synchronous, what happens if the printer is offline, required permissions, or what the return value indicates (no output schema exists).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single efficient sentence with no redundancy. However, given the high parameter complexity and lack of schema documentation, this brevity represents under-specification rather than appropriate conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 5 undocumented required parameters, no annotations, and no output schema, the description is severely incomplete. It establishes the core action but leaves the agent without sufficient information to correctly populate parameters or handle responses.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage across 5 required parameters, the description completely fails to compensate. Critical semantic gaps remain unresolved: the distinction between device_name and control_sn, valid media_format values, and whether url requires a specific protocol.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool sends a document to a specific printer, distinguishing it from sibling tools that query printer details (query_printer_detail) or update settings (update_printer_*). However, it uses 'Send' rather than 'Print', which slightly weakens the specific action intent.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus upload_file (a sibling tool) or whether the document must be pre-uploaded. There are no prerequisites, exclusions, or workflow context provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
query_printer_detailC
Query printer capabilities for a specific printer or shared device.
| Name | Required | Description | Default |
|---|---|---|---|
| printer_name | No | ||
| share_sn | No | ||
| device_type | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It fails to specify what 'capabilities' are returned, error handling behavior (e.g., printer not found), or whether this operation requires specific permissions. The term 'Query' implies read-only, but explicit confirmation is absent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single-sentence description is efficiently structured and front-loaded with the action and target. However, extreme brevity becomes a liability given the lack of schema documentation and annotations, leaving critical information unstated.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Inadequate for the tool's complexity. With three optional parameters (suggesting multiple query patterns), zero schema descriptions, no output schema, and no annotations, the description should explain parameter relationships, return value structure, and lookup precedence. It provides none of these.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Given 0% schema description coverage, the description must compensate but only partially succeeds. It mentions 'specific printer or shared device' implying 'printer_name' and 'share_sn', but does not explain the distinction between them, valid values for 'device_type', or that all parameters are optional with null defaults.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description provides a clear verb ('Query') and resource ('printer capabilities'), and distinguishes from sibling 'query_printers' by specifying 'for a specific printer'. However, it could better differentiate from the 'update_printer_*' siblings by explicitly stating this is a read-only information retrieval operation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance provided on when to use this versus 'query_printers', or how to select between the identification parameters ('printer_name' vs 'share_sn'). The description does not indicate that all parameters are optional or suggest how to identify the target device.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
query_printersA
List printers available to the current user.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses user-scoping ('current user') implying authorization context, but does not describe the return format, pagination behavior, or whether the listing includes offline printers.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description consists of a single, efficient sentence with no extraneous words. It is appropriately front-loaded with the core action and subject.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that this is a simple zero-parameter listing tool without an output schema, the description is minimally complete. It could be improved by mentioning that it returns a collection/list of printer objects, but the current description is sufficient for invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has zero parameters. Per the scoring rules, zero parameters establishes a baseline score of 4. The description appropriately reflects that no filtering parameters are required.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description provides a clear verb ('List') and resource ('printers') with scope ('available to the current user'). However, it does not explicitly differentiate from the sibling 'query_printer_detail' (which likely retrieves specific printer information) in the text itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus siblings like 'query_printer_detail', 'direct_print_document', or the various update_printer_* tools. It does not state prerequisites or conditions for use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
update_printer_colorC
Update color mode for an existing roaming task.
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| color | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It indicates mutation via 'Update' and specifies the roaming task context, but fails to disclose valid color values (string|null is ambiguous), error behavior for missing tasks, or whether updates are immediate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single sentence is front-loaded and contains no redundant words. However, it is arguably too concise given the lack of schema coverage and annotations, leaving necessary context undocumented.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a mutation tool with 2 parameters and 0% schema coverage, the description is insufficient. It fails to specify valid color input values, explain the null default behavior, or describe what confirms a successful update (no output schema exists to compensate).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description partially compensates by identifying 'color' as a 'mode' and 'task_id' as referring to an 'existing roaming task'. However, it omits valid color enumerations or formats (e.g., 'color' vs 'monochrome'), which is critical given the lack of schema documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb (Update) and resource (color mode for an existing roaming task). It distinguishes from siblings like update_printer_copies by specifying 'roaming task' rather than printer hardware, and links to create_roaming_task.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
While 'existing roaming task' implies a prerequisite (likely created via create_roaming_task), there is no explicit when-to-use guidance or differentiation from other update_printer_* siblings. No mention of what constitutes valid color values.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
update_printer_copiesC
Update copy count for an existing roaming task.
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| copies | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the mutation action but fails to disclose idempotency, error conditions, side effects on the print job state, or whether this triggers immediate reprocessing.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single sentence contains no redundant words and front-loads the action, though its extreme brevity contributes to informational gaps given the lack of supporting schema descriptions and annotations.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero schema descriptions, no annotations, and no output schema, the description is insufficiently complete. It omits behavioral implications of changing copy counts mid-process and lacks parameter specifications necessary for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description must compensate for both parameters. It maps 'copy count' to the 'copies' parameter and implies 'task_id' via 'existing roaming task', but provides no format constraints, valid ranges (e.g., max copies), or whether task_id is a UUID or integer.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description provides a specific verb ('Update') and resource ('copy count') and scopes it to 'existing roaming task', clearly distinguishing it from sibling tools like update_printer_color or update_printer_paper which handle different attributes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Mentioning 'existing roaming task' implicitly signals that the task must already exist (suggesting create_roaming_task is a prerequisite), but lacks explicit guidance on when to use this versus direct_print_document or other alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
update_printer_paperA
Update paper size for an existing roaming task using a preset name or custom dimensions in millimeters.
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| paper | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full disclosure burden. It successfully explains the polymorphic input behavior (preset name string vs. custom dimensions object), but fails to mention mutation effects, return values, error conditions, or whether changes are immediate or queued.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single sentence is tightly constructed with zero redundancy: 'Update paper size' (action), 'for an existing roaming task' (scope), and 'using a preset name or custom dimensions in millimeters' (parameter semantics). Every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple two-parameter update tool with no output schema, the description adequately covers the core functionality and input formats. However, it should ideally mention what constitutes a successful response or common error conditions (e.g., invalid task_id or unsupported preset names) to be fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Given 0% schema description coverage, the description compensates effectively by explaining that 'paper' accepts either a preset name (string) or custom dimensions in millimeters (object), clarifying the anyOf schema structure. It implies task_id references an existing roaming task, though explicit parameter naming would strengthen this further.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the specific action ('Update paper size'), the target resource ('existing roaming task'), and distinguishes itself from sibling tools like update_printer_color or update_printer_copies by specifying 'paper size' as the particular attribute being modified.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'existing roaming task' implies this tool is for modifying previously created tasks (likely via create_roaming_task), providing implicit workflow context. However, it lacks explicit guidance on when to use this versus direct_print_document or prerequisites for the roaming task state.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
update_printer_sideC
Update simplex or duplex settings for an existing roaming task.
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| side | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full disclosure burden but provides minimal behavioral context. It doesn't specify valid values for the side parameter (e.g., 'simplex' vs 'duplex'), explain the default null behavior, indicate idempotency, or mention permission requirements for modifying tasks.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence of 9 words with zero redundancy. The information is front-loaded with the action verb 'Update'. However, given the 0% schema coverage and lack of annotations, the brevity contributes to under-documentation rather than efficient communication.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 2-parameter mutation tool with no output schema and no annotations, the description is insufficient. It omits critical details like valid enum values for 'side', the effect of null, error conditions, or whether the update is persistent or immediate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, requiring the description to compensate. While 'simplex or duplex' hints at valid values for the 'side' parameter, it doesn't confirm exact string values, explain the null default, or describe what 'task_id' represents (format/source). Insufficient compensation for complete lack of schema documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool updates 'simplex or duplex settings' (specific resource) for an 'existing roaming task' (scope). It effectively distinguishes from sibling update_printer_* tools (color, copies, paper) by specifying the duplex/simplex domain, though it assumes familiarity with 'roaming task' from create_roaming_task.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The mention of 'existing roaming task' implies a prerequisite (task must exist first), suggesting usage order. However, it lacks explicit guidance on when to use this versus direct_print_document or other update tools, and doesn't clarify that null side might reset to default.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
upload_fileA
Upload a local file and return a public URL that the print service can read.
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden. It discloses that the tool returns a 'public URL' (important security context) and implies a side effect (upload). However, it omits critical mutation details: URL persistence, file cleanup policies, size limits, or authentication requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single 13-word sentence with zero waste. It front-loads the action ('Upload'), specifies the input ('local file'), output ('public URL'), and domain context ('print service') with no redundant phrases.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter tool without output schema or annotations, the description adequately covers the basic contract (input file → output URL). However, it leaves operational gaps regarding the 'public URL' security implications, longevity, and whether the upload is temporary or persistent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% (file_path has no description). The text adds minimal semantic value by implying file_path is a local filesystem path ('local file'), but fails to specify format constraints, absolute vs. relative paths, or supported file types needed to fully compensate for the schema gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses specific verb 'Upload' with clear resource 'local file' and distinguishes itself from printer-management siblings by specifying the outcome is 'a public URL that the print service can read.' This clearly positions it as a file preparation step for printing.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides implied usage context by mentioning 'print service can read,' suggesting when to use it (when files need to be made accessible for printing). However, it lacks explicit when-to-use guidance versus direct_print_document or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
10 tool updates
v0.1.2- First observed
check_install_progress - First observed
create_roaming_task - First observed
direct_print_document - First observed
query_printer_detail - First observed
query_printers - First observed
update_printer_color - First observed
update_printer_copies - First observed
update_printer_paper - First observed
update_printer_side - First observed
upload_file
TDQS
Scored across 10 tools
The four update_printer_* tools are named as if they configure printer hardware settings, but they actually modify roaming task parameters. This creates dangerous ambiguity with query_printer_detail (which queries actual printer capabilities), forcing agents to rely entirely on descriptions to distinguish printer properties from job configuration.
While most tools follow verb_noun patterns (create_roaming_task, upload_file), direct_print_document breaks convention by using an adjective-noun structure. More critically, the update_printer_* prefix is domain-inaccurate since these modify tasks, not printers, creating inconsistency with the actual object model.
Ten tools is a reasonable count for cloud printing functionality, covering environment checks, printer discovery, file handling, and dual print workflows. However, the granularity of four separate single-property update tools feels slightly excessive compared to a unified task update operation.
Basic printing and discovery are covered, but the roaming task workflow lacks lifecycle management: you can create and modify tasks, but cannot submit, check status, cancel, or list jobs. This leaves agents unable to track print completion or handle failures in the roaming workflow.
Maintenance
Related MCP Connectors
Cloud printing integration for AI-assisted app development via ezeep.
Print and mail physical documents in the US via USPS, with quotes, agent payment and tracking.
Print & mail PDF/HTML/Markdown/text/DOCX/images to US addresses; pay per call in x402 USDC on Base.
Cloud PDF generation from HTML, CSS and XSL-FO, with PDF/A and PDF/UA support.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables 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.68 npm12MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Memobird thermal printers to print text, HTML, web pages, and images directly from MCP-enabled clients. It includes tools for device binding, image conversion, and monitoring print job status.2 npm1ISC
- AlicenseAqualityFmaintenanceConnect AI agents to physical printers. Print receipts, shipping labels, and packing slips to your existing BizPrint-connected printers from Claude and other MCP clients.71MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to submit PDFs or JSON-rendered templates to local printers, check printer status, and manage print jobs through MCP tools.214 npmMIT