mcpField
智
智睦云打印

智睦云打印

ローカル
github.com/zimsoft生産性029 週間前に更新
リポジトリ

智睦云打印 について

智睦云打印は、対応クライアントからクラウド印刷を管理するMCPサーバーです。プリンター検索、ファイルアップロード、印刷タスクの作成や設定変更、指定機器への直接印刷に対応します。

主な機能

  1. 01クラウド印刷環境の確認
  2. 02プリンターと機器の機能の検索
  3. 03印刷用ローカルファイルのアップロード
  4. 04ローミング印刷タスクの作成
  5. 05両面・カラー・部数・用紙の調整
  6. 06指定機器への直接印刷

活用シーン

  1. 01クラウド印刷環境の準備状況の確認
  2. 02文書をアップロードして印刷キューに登録
  3. 03キュー内タスクを両面または白黒印刷に変更
  4. 04オフィスのプリンターへファイルを直接送信

MCP 対応

このMCPサーバーはMCPクライアントにクラウド印刷ツールを提供し、stdio接続を想定しています。環境確認、プリンター検索、ファイルアップロード、ローミングタスク、設定変更、直接印刷に対応します。

#print

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "webprinter": {
      "command": "npx",
      "args": [
        "-y",
        "webprinter_mcp"
      ],
      "env": {
        "WEBPRINTER_ACCESS_TOKEN": "<WEBPRINTER_ACCESS_TOKEN>"
      }
    }
  }
}
起動コマンドnpx -y webprinter_mcp
設定が必要な環境変数
WEBPRINTER_ACCESS_TOKENシークレット

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmwebprinter_mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

智睦云打印MCP

webprinter_mcp は、クラウド印刷用の MCP サーバーです。
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)

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 実行環境が必要です。

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 サーバーを起動することを示します
  • type
    • 現在のクライアントが npx 方式で接続することを示します

ツール一覧

現在、MCP サーバーは以下のツールを提供しています。

  • 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
    • ファイルを指定したプリンターに直接送信して印刷します

印刷の一連の流れを実行する機能セットとして捉えることもできます。

  1. まず環境を確認します：check_install_progress
  2. 次にプリンターを確認します：query_printers / query_printer_detail
  3. ファイルをアップロードします：upload_file
  4. ローミング印刷タスクを作成します：create_roaming_task
  5. 必要に応じてタスクのパラメーターを調整します：update_printer_side / update_printer_color / update_printer_copies / update_printer_paper
  6. または、直接印刷します：direct_print_document

ツールの説明

各ツールの用途、動作、主なパラメーター、使用上のアドバイスを以下に示します。MCP プラットフォーム、ディレクトリサイト、接続ガイドでの紹介にご利用ください。

check_install_progress
  • 用途
    • 現在のアカウント、クライアント、印刷環境で、クラウド印刷を利用できる状態か確認します
  • 使用するタイミング
    • 初回接続時に最初に呼び出します
    • 印刷できない、プリンターが見つからない、タスクの送信に失敗するといった場合に、まず呼び出します
  • 動作
    • クラウド印刷プラットフォームに現在のインストール状況と設定状況を問い合わせます
    • 印刷タスクは変更しません
  • パラメーター
    • なし
  • 戻り値
    • 現在の環境チェック結果を返します。通常、クライアント、デバイス、共有設定の完了状況を判断するために使用できます
  • 使用上のアドバイス
    • すべての印刷フローの最初のステップとして呼び出すことをおすすめします
  • 使用例
    • 「まず、現在の環境でクラウド印刷を利用できるか確認して」
query_printers
  • 用途
    • 現在のアカウントで利用可能なプリンターの一覧を取得します
  • 使用するタイミング
    • ユーザーが利用可能なプリンターを確認したいとき
    • 直接印刷の前に、対象のプリンターが存在するか確認したいとき
  • 動作
    • プリンターの一覧を返します
    • 非表示のプリンターには、ローミング印刷タスクのみ対応していることを示す印が付けられます
  • パラメーター
    • なし
  • 戻り値
    • 一般的なフィールドには、プリンター名、別名、オンライン状態、コントローラー番号、非表示かどうかなどがあります
  • 使用上のアドバイス
    • ユーザーが「特定のプリンターに印刷して」と言った場合は、先にこのツールを呼び出し、デバイス名と制御番号を確認することをおすすめします
  • 使用例
    • 「現在利用できるプリンターを確認して」
query_printer_detail
  • 用途
    • プリンターまたは共有デバイスの詳細な機能情報を取得します
  • 使用するタイミング
    • ユーザーがデバイスで利用可能な機能を確認したいとき
    • 印刷の前に、デバイスの種類、共有番号、詳細なパラメーターを確認したいとき
  • 動作
    • プリンター名、共有番号、またはデバイスの種類に基づいて詳細情報を返します
  • パラメーター
    • printer_name
      • プリンター名。省略可能です
    • share_sn
      • 共有デバイス番号。省略可能です
    • device_type
      • デバイスの種類。省略可能です。printer、scanner、camera に対応しています
  • 戻り値
    • 指定したデバイスの詳細な機能情報または設定データを返します
  • 使用上のアドバイス
    • 検索範囲が広くなりすぎないよう、フィルター条件を少なくとも1つ指定してください
  • 使用例
    • 「受付にあるプリンターで利用できる機能を確認して」
upload_file
  • 用途
    • ローカルファイルをアップロードし、後続の印刷に使用できる公開 URL を取得します
  • 使用するタイミング
    • 元ファイルがローカルディスクにあるとき
    • ローミング印刷または直接印刷の前に、公開ファイル URL がないとき
  • 動作
    • ローカルファイルを読み込み、クラウドにアップロードします
    • 印刷サービスが読み取れるファイル URL を返します
  • パラメーター
    • file_path
      • ローカルファイルのパス。必須です
  • 戻り値
    • アップロードしたファイルの情報とアクセス可能な URL を返します
  • 使用上のアドバイス
    • ファイルがすでに公開 URL になっている場合は、この手順を省略できます
  • 使用例
    • 「デスクトップにある PDF をアップロードして、印刷用の URL を教えて」
create_roaming_task
  • 用途
    • ローミング印刷タスクを作成し、ファイルを印刷キューに入れて後続の処理に備えます
  • 使用するタイミング
    • 特定のデバイスですぐに印刷するのではなく、先に印刷タスクを作成したいとき
  • 動作
    • ファイル名、ファイル URL、ファイル形式に基づいてローミング印刷タスクを作成します
    • 成功するとタスク ID を返します
  • パラメーター
    • file_name
      • ファイルの表示名。必須です
    • url
      • ファイルの公開 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
      • ファイルの公開 URL。必須
    • media_format
      • ファイル形式。必須
    • device_name
      • 対象プリンター名。必須
    • control_sn
      • 対象プリンターの制御端末番号。必須
  • 戻り値
    • 直接印刷の結果を返します
  • 使用上のヒント
    • まず query_printers を呼び出して、対象プリンター名と制御端末番号を確認することをおすすめします
    • ローカルファイルの場合は、先に upload_file を呼び出してください
  • 使用例
    • 「このファイルを受付のプリンターに直接印刷して」

初回接続時のおすすめの試し方

初めて使うときは、次の手順で進めることをおすすめします。

まず、現在のアカウントがクラウド印刷を利用できる状態か確認します

次のように伝えます。

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

結果にクライアントまたはデバイスの準備ができていないと表示された場合は、WebPrinter 側のインストールと共有設定を完了してください。

次に、現在利用可能なプリンターの一覧を表示します

次のように伝えます。

  • 「現在利用できるプリンターを確認して」

この手順では通常、次の情報を取得できます。

  • プリンター名
  • プリンターの別名
  • オンライン状態
  • 制御端末番号
ローカルファイルがある場合は、まずアップロードします

次のように伝えます。

  • 「ローカルの PDF をアップロードして、印刷可能な URL を教えて」

ローカルでデバッグするときの一般的なパラメーターは、次のとおりです。

{
  "file_path": "C:\\\\docs\\\\report.pdf"
}
次に、「ローミング印刷」と「直接印刷」のどちらにするか決めます

まず印刷キューに追加するだけの場合は、次のように伝えます。

  • "このファイルをローミング印刷に送信して" または
  • 「このファイルを印刷キューに追加して」

特定のプリンターですぐに印刷する場合は、次のように伝えます。

  • 「このファイルをオフィスにある HP プリンターに直接印刷して」

口語的な使用例

次のような指示は、この MCP での処理に適しています。

  • 「現在のクラウド印刷環境が使えるか確認して」
  • 「利用できるプリンターを確認して」
  • 「デスクトップにある PDF をアップロードして」
  • 「このウェブページを印刷キューに追加して」
  • 「受付のプリンターに直接印刷して」
  • 「さっきのタスクを両面印刷に変更して」

よくある質問

webprinter_mcp を実行しても反応がないのはなぜですか

これは正常な動作です。
起動後は MCP クライアントから stdio で接続されるのを待ち続けます。通常のコマンドラインツールのように、すぐに大量の情報を表示することはありません。

起動時に token 関連のエラーが発生した場合はどうすればよいですか

まず、次の場所から token を取得してください。

  • [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

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。