webprinter_mcp は、クラウドプリント用の MCP Server です。
お使いの MCP クライアントが stdio タイプの MCP をサポートしていれば、これを通じてファイルのアップロード、プリンターの検索、印刷タスクの送信、および直接印刷を行うことができます。
これは「印刷タスクを処理してくれるツール」と考えてください。
例えば、この MCP を統合した AI に対して次のように指示できます：
「今使えるプリンターがあるか確認して」
「このファイルをアップロードして、印刷の準備をして」
「このファイルを印刷キューに追加して」
「オフィスにあるあのプリンターに直接印刷して」
「さっきのタスクを両面印刷に変更して」
Related MCP server: printagent
まず智睦クラウドプリントサーバーをインストールし、プリンターの共有設定を完了させる必要があります。インストールパッケージは智睦クラウドプリントから入手してください：
https://any.webprinter.cn
次に、クラウドプリントのアクセストークン(token)を取得する必要があります。
取得先：
[https://any.webprinter.cn/get-ai-server-token](https://any.webprinter.cn/get-ai-server-token)
トークンを取得したら、環境変数を設定します：
WEBPRINTER_ACCESS_TOKEN：必須
pip install webprinter_mcppip install .ローカルで起動できるか確認したい場合は、以下を実行してください：
webprinter_mcpまたは：
python -m webprinter_mcp注意：このコマンドを実行しても、通常はプロンプトが表示されることはありません。 MCP クライアントからの接続を待機する状態になりますが、これは正常な動作です。
現在、このプロジェクトは stdio 方式での接続に適しています。
すでにマシンにこのパッケージをインストールしている場合は、以下のように設定することをお勧めします：
{
"type": "stdio",
"config": {
"mcpServers": {
"webprinter": {
"type": "stdio",
"command": "webprinter_mcp",
"args": [],
"env": {
"WEBPRINTER_ACCESS_TOKEN": "your-access-token"
}
}
}
}
}クライアントが npx スタイルをサポートしている場合は、以下のように設定できます：
{
"type": "stdio",
"config": {
"mcpServers": {
"webprinter": {
"type": "npx",
"command": "npx",
"args": ["-y", "webprinter_mcp"],
"env": {
"WEBPRINTER_ACCESS_TOKEN": "your-access-token"
}
}
}
}
}注意：npx webprinter_mcp を使用する場合でも、マシンには Python 実行環境が必要です。
mcpServers 設定を直接使用する場合MCP クライアントが mcpServers 構造を直接受け入れる場合は、以下の設定をそのまま使用できます：
{
"mcpServers": {
"webprinter": {
"args": [
"-y",
"webprinter_mcp"
],
"command": "npx",
"env": {
"WEBPRINTER_ACCESS_TOKEN": "your-access-token"
},
"type": "npx"
}
}
}その中で：
WEBPRINTER_ACCESS_TOKEN
https://any.webprinter.cn/get-ai-server-token から事前に取得する必要があります
command と args
npx webprinter_mcp を通じて MCP Server を起動することを意味します
type
現在のクライアントが npx 方式で接続していることを意味します
現在、この MCP Server は以下のツールを提供しています：
check_install_progress
現在のアカウントとデバイス環境がクラウドプリント機能に対応しているか確認します
query_printers
現在のアカウントで使用可能なプリンターリストを照会します
query_printer_detail
指定したプリンターまたは共有デバイスの詳細な能力情報を照会します
upload_file
ローカルファイルをアップロードし、印刷に使用できる公開 URL を返します
create_roaming_task
ファイル URL に基づいてローミング印刷タスクを作成します
update_printer_side
ローミング印刷タスクの片面/両面設定を変更します
update_printer_color
ローミング印刷タスクのカラー/モノクロ設定を変更します
update_printer_copies
ローミング印刷タスクの印刷部数を変更します
update_printer_paper
ローミング印刷タスクの用紙サイズを変更します（A3、A4 などのプリセットや、カスタムの幅と高さをサポート）
direct_print_document
ファイルを指定したプリンターに直接送信して印刷します
これは一連の完全な印刷フロー機能として理解することもできます：
環境チェック：check_install_progress
プリンター確認：query_printers / query_printer_detail
ファイルアップロード：upload_file
ローミング印刷作成：create_roaming_task
タスクパラメーターの調整：update_printer_side / update_printer_color / update_printer_copies / update_printer_paper
または直接印刷：direct_print_document
各ツールについて「用途、動作、主要パラメーター、使用上のアドバイス」の形式で説明します。
check_install_progress用途
現在のアカウント、クライアント、印刷環境がクラウドプリント機能に対応しているか確認します
使用タイミング
初回接続時に最初に呼び出す
印刷できない、プリンターが見つからない、タスク送信に失敗する場合に優先的に呼び出す
動作
クラウドプリントプラットフォームに対して現在のインストールおよび設定状態を照会します
印刷タスクの変更は行いません
パラメーター
なし
戻り値
現在の環境チェック結果。通常、クライアント、デバイス、または共有設定が完了しているかの判断に使用します
使用上のアドバイス
すべての印刷フローの最初のステップとして実行することをお勧めします
指示の例
「まず現在の環境でクラウドプリントが使えるか確認して」
query_printers用途
現在のアカウントで使用可能なプリンターリストを照会します
使用タイミング
ユーザーが利用可能なプリンターを確認したいとき
直接印刷の前に、対象のプリンターが存在するか確認するとき
動作
プリンターリストを返します
非表示のプリンターは、ローミング印刷タスクのみサポートとしてマークされます
パラメーター
なし
戻り値
プリンター名、エイリアス、オンライン状態、制御端番号、非表示フラグなどの一般的なフィールド
使用上のアドバイス
ユーザーが「あのプリンターで印刷して」と言った場合、まずこのツールでデバイス名と制御番号を確認することをお勧めします
指示の例
「今使えるプリンターを教えて」
query_printer_detail用途
特定のプリンターまたは共有デバイスの詳細な能力情報を照会します
使用タイミング
ユーザーがデバイスのサポート能力を確認したいとき
印刷前にデバイスタイプ、共有番号、詳細パラメーターを確認するとき
動作
プリンター名、共有番号、またはデバイスタイプに基づいて詳細情報を返します
パラメーター
printer_name：プリンター名（任意）
share_sn：共有デバイス番号（任意）
device_type：デバイスタイプ（任意、printer、scanner、camera をサポート）
戻り値
指定デバイスの詳細な能力または設定データ
使用上のアドバイス
検索範囲が広くなりすぎないよう、少なくとも1つのフィルタ条件を提供してください
指示の例
「受付にあるプリンターがどんな機能に対応しているか見て」
upload_file用途
ローカルファイルをアップロードし、後続の印刷で使用できる公開 URL を取得します
使用タイミング
ソースファイルがローカルディスクにあるとき
ローミング印刷や直接印刷の前に、公開ファイルアドレスがないとき
動作
ローカルファイルを読み込んでクラウドにアップロードします
印刷サービスが読み取れるファイルアドレスを返します
パラメーター
file_path：ローカルファイルパス（必須）
戻り値
アップロード後のファイル情報とアクセス可能なアドレス
使用上のアドバイス
ファイルがすでに公開 URL である場合は、このステップをスキップできます
指示の例
「デスクトップにある PDF をアップロードして、印刷用のアドレスを教えて」
create_roaming_task用途
ローミング印刷タスクを作成し、ファイルを印刷キューに入れて後続の処理を待ちます
使用タイミング
特定のデバイスにすぐに印刷するのではなく、まず印刷タスクを生成したいとき
動作
ファイル名、ファイル URL、ファイルタイプに基づいてローミング印刷タスクを作成します
成功するとタスク ID を返します
パラメーター
file_name：ファイル表示名（必須）
url：ファイルの公開アドレス（必須）
media_format：ファイル形式（必須、PDF、PNG、JPG、WORD、EXCEL、PPT など）
戻り値
新規作成されたローミングタスク ID
使用上のアドバイス
後で片面/両面、カラー、部数、用紙サイズを変更するには、このタスク ID が必要です
指示の例
「このファイルをローミング印刷タスクとして送信して」
update_printer_side用途
ローミング印刷タスクの片面/両面設定を変更します
使用タイミング
ユーザーが片面、両面、長辺綴じ、短辺綴じを明示的に指定したとき
動作
タスク ID に基づいてタスクの印刷面設定を更新します
パラメーター
task_id：ローミングタスク ID（必須）
side：選択値：ONESIDE、DUPLEX、TUMBLE
戻り値
更新結果
使用上のアドバイス
すでに作成済みのローミングタスクに適用されます。直接印刷タスクには使用しません
指示の例
「タスク 123 を両面印刷に変更して」
update_printer_color用途
ローミング印刷タスクのカラーモードを変更します
使用タイミング
ユーザーがカラー、モノクロ、グレースケール印刷を明示的に指定したとき
動作
タスク ID に基づいてカラーモードを更新します
パラメーター
task_id：ローミングタスク ID（必須）
color：選択値：COLOR、MONOCHROME
戻り値
更新結果
使用上のアドバイス
ユーザーが「モノクロ印刷」と言った場合は MONOCHROME に変換してください
指示の例
「タスク 123 をモノクロ印刷に変更して」
update_printer_copies用途
ローミング印刷タスクの印刷部数を変更します
使用タイミング
ユーザーが「2部印刷」「3部印刷」と言ったとき
動作
タスク ID に基づいて印刷部数を更新します
パラメーター
task_id：ローミングタスク ID（必須）
copies：印刷部数（必須、1 以上）
戻り値
更新結果
使用上のアドバイス
ユーザーが部数を明示していない場合は、勝手に変更しないでください
指示の例
「タスク 123 を3部印刷に変更して」
update_printer_paper用途
ローミング印刷タスクの用紙サイズを変更します
使用タイミング
ユーザーが A3、A4、A5、Letter などの用紙サイズを指定したとき
ユーザーが直接幅と高さを指定したとき
動作
標準的な用紙名をミリ単位の幅と高さに自動変換します
カスタムの width と height の直接入力もサポートします
パラメーター
task_id：ローミングタスク ID（必須）
paper：用紙名（例：A4）またはオブジェクト（例：{"width": 210, "height": 297}）
戻り値
更新結果
使用上のアドバイス
幅と高さの単位はミリメートルで統一してください
現在サポートされているプリセット：A0-A6、B4、B5、LETTER、LEGAL、TABLOID
指示の例
「タスク 123 を A4 用紙に変更して」
「タスク 123 を幅 210、高さ 297 の用紙に変更して」
direct_print_document用途
ファイルを指定したプリンターに直接送信します
使用タイミング
ユーザーが特定のプリンターへの即時印刷を明示的に指定したとき
動作
ファイル情報とターゲットデバイス情報に基づいて直接印刷を開始します
ターゲットが非表示プリンターの場合、直接印刷をブロックし、ローミングタスクの使用を促します
パラメーター
file_name：ファイル表示名（必須）
url：ファイルの公開アドレス（必須）
media_format：ファイル形式（必須）
device_name：ターゲットプリンター名（必須）
control_sn：ターゲットプリンターの制御端番号（必須）
戻り値
直接印刷の結果
使用上のアドバイス
事前に query_printers を呼び出して、ターゲットのプリンター名と制御端番号を確認することをお勧めします
ローカルファイルの場合は、先に upload_file を呼び出してください
指示の例
「このファイルを直接受付のプリンターで印刷して」
初めて使用する場合は、以下の手順で進めることをお勧めします：
次のように指示します：
「まず現在の環境でクラウドプリントが正常に使えるか確認して」
戻り値でクライアントやデバイスの準備ができていないと表示された場合は、WebPrinter 側のインストールと共有設定を完了させてください。
次のように指示します：
「今使えるプリンターを教えて」
このステップで通常は以下を取得できます：
プリンター名
プリンターのエイリアス
オンライン状態
制御端番号
次のように指示します：
「ローカルのこの PDF をアップロードして、印刷用のアドレスを教えて」
ローカルデバッグ時の一般的なパラメーターは以下のようになります：
{
"file_path": "C:\\\\docs\\\\report.pdf"
}印刷キューに入れたいだけの場合は：
「このファイルをローミング印刷として送信して」 または
「このファイルを印刷キューに追加して」
特定のプリンターですぐに印刷したい場合は：
「このファイルを直接オフィスにある HP プリンターで印刷して」
以下のような言い回しは、この MCP で処理するのに適しています：
「現在のクラウドプリント環境が使えるかチェックして」
「使えるプリンターを教えて」
「デスクトップの PDF をアップロードして」
「このウェブページを印刷キューに追加して」
「受付のプリンターで直接印刷して」
「さっきのタスクを両面印刷にして」
webprinter_mcp を実行しても反応がないこれは正常です。
起動後は stdio を通じた MCP クライアントからの接続を待機し続けるため、通常のコマンドラインツールのように多くの情報を出力することはありません。
まずこちらでトークンを取得してください：
[https://get-ai-token.webprinter.cn](https://any.webprinter.cn/get-ai-server-token)
その後、以下が設定されているか確認してください：
WEBPRINTER_ACCESS_TOKEN
webprinter_mcp が見つからない通常、Python の Scripts ディレクトリが PATH に追加されていないことが原因です。
その場合は、直接以下のように実行できます：
python -m webprinter_mcp作成済みのローミング印刷タスクに対して、以下の設定を継続して変更できます：
update_printer_side(task_id, side)
update_printer_color(task_id, color)
update_printer_copies(task_id, copies)
update_printer_paper(task_id, paper)
task_id：ローミング印刷タスク ID
side：ONESIDE（片面）、DUPLEX（両面長辺綴じ）、TUMBLE（両面短辺綴じ）
color：COLOR（カラー）、MONOCHROME（モノクロ）
copies：整数（1 以上）
paper：用紙名（A3、A4、A5、LETTER など）またはカスタムオブジェクト：{"width": 210, "height": 297}（単位はミリメートル）
MCP クライアントで自然言語を使用して呼び出す場合：
「タスク 123 を両面印刷にして」
「タスク 123 をモノクロ印刷にして」
「タスク 123 を3部印刷にして」
「タスク 123 を A4 用紙にして」
「タスク 123 を幅 210、高さ 297 の用紙にして」
ローカル CLI でデバッグする場合：
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 297Check whether the user's cloud print environment is fully configured.
Inputs: no named parameters.
Create a roaming print task from a public document URL.
Inputs: file_name (required), url (required), media_format (required).
Send a document directly to a specific printer.
Inputs: file_name (required), url (required), media_format (required), device_name (required), +1 more.
Query printer capabilities for a specific printer or shared device.
Inputs: printer_name, share_sn, device_type.
List printers available to the current user.
Inputs: no named parameters.
Update color mode for an existing roaming task.
Inputs: task_id (required), color.
Update copy count for an existing roaming task.
Inputs: task_id (required), copies (required).
Update paper size for an existing roaming task using a preset name or custom dimensions in millimeters.
Inputs: task_id (required), paper (required).
Update simplex or duplex settings for an existing roaming task.
Inputs: task_id (required), side.
Upload a local file and return a public URL that the print service can read.
Inputs: file_path (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Cloud printing integration for AI-assisted app development via ezeep.
Print from Claude and ChatGPT to your own printer. Free for 5 prints a month; Plus $7.99/mo.
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.