智睦クラウドプリントMCP

webprinter_mcp は、クラウドプリント用の MCP Server です。 お使いの MCP クライアントが stdio タイプの MCP をサポートしていれば、これを通じてファイルのアップロード、プリンターの検索、印刷タスクの送信、および直接印刷を行うことができます。

何ができるのか

これは「印刷タスクを処理してくれるツール」だと考えてください。

例えば、この MCP を接続した AI に対して次のように指示できます：

• 「今使えるプリンターがあるか確認して」

• 「このファイルをアップロードして、印刷の準備をして」

• 「このファイルを印刷キューに追加して」

• 「オフィスにあるあのプリンターに直接印刷して」

• 「さっきのタスクを両面印刷に変更して」

使用前の準備

まず智睦クラウドプリントサーバーをインストールし、プリンターの共有設定を完了させる必要があります。インストールパッケージは智睦クラウドプリントから入手してください：

• 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 でインストール

pip install webprinter_mcp

またはソースコードからインストール

pip install .

起動方法

ローカルで起動できるか確認したい場合は、以下を実行してください：

webprinter_mcp

または：

python -m webprinter_mcp

注意：このコマンドを実行しても、通常はプロンプトメッセージは表示されません。 MCP クライアントからの接続を待機する状態になりますが、これは正常な動作です。

MCP クライアントでの設定方法

現在、このプロジェクトは stdio 方式での接続に適しています。

ローカル Python 方式

すでにマシンにこのパッケージをインストールしている場合は、以下のように設定することをお勧めします：

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

npx 方式

クライアントが 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 実行環境が必要です。

初回接続時の推奨手順

初めて使用する場合は、以下の手順で進めることをお勧めします：

まず、現在のアカウントがクラウドプリントの条件を満たしているか確認する

次のように考えてください：

• 「まず、現在の環境でクラウドプリントが正常に使えるか確認して」

クライアントやデバイスの準備ができていないと表示された場合は、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 297