MCP для облачной печати Zhimu

webprinter_mcp — это MCP-сервер для облачной печати. Если ваш MCP-клиент поддерживает тип stdio, вы можете использовать его для загрузки файлов, поиска принтеров, отправки задач на печать и прямой печати.

Что он может делать

Вы можете воспринимать его как «инструмент, который берет на себя обработку задач печати».

Например, вы можете сказать ИИ, подключенному к этому MCP:

• «Проверь, есть ли сейчас доступные принтеры»

• «Загрузи этот файл, подготовь его к печати»

• «Добавь этот файл в очередь печати»

• «Распечатай напрямую на офисном принтере»

• «Измени настройки предыдущей задачи на двустороннюю печать»

Подготовка перед использованием

Вам необходимо сначала установить сервер облачной печати Zhimu и настроить общий доступ к принтерам. Получите установочный пакет на сайте облачной печати Zhimu:

• https://any.webprinter.cn

Затем вам нужно получить токен доступа к облачной печати.

Адрес для получения:

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

Затем попросите вывести список доступных принтеров

Можно сказать так:

• «Покажи, какие принтеры сейчас доступны»

На этом этапе обычно можно получить:

• Имя принтера

• Псевдоним принтера

• Статус онлайн

• ID управляющего устройства

Если у вас есть локальный файл, сначала загрузите его

Можно сформулировать так:

• «Загрузи этот PDF-файл с моего компьютера и дай мне ссылку для печати»

При локальной отладке параметры обычно выглядят так:

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

Затем решите: «роуминг-печать» или «прямая печать»

Если вы хотите просто добавить задачу в очередь печати, можно сказать:

• «Отправь этот файл на роуминг-печать» или

• «Добавь этот файл в очередь печати»

Если вы хотите немедленно распечатать на конкретном принтере, можно сказать:

• «Распечатай этот файл напрямую на офисном принтере HP»

Примеры более разговорных запросов

Этот MCP хорошо справляется с такими запросами:

• «Проверь, работает ли сейчас облачная печать»

• «Какие принтеры доступны?»

• «Загрузи PDF-файл с моего рабочего стола»

• «Добавь эту веб-страницу в очередь печати»

• «Распечатай напрямую на принтере на ресепшене»

• «Сделай предыдущую задачу двусторонней»

Часто задаваемые вопросы

Почему после запуска webprinter_mcp ничего не происходит?

Это нормально. После запуска он будет ждать подключения MCP-клиента через stdio и не будет выводить много информации, как обычные инструменты командной строки.

Что делать, если при запуске возникает ошибка, связанная с токеном?

Сначала получите токен здесь:

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

Затем убедитесь, что вы установили:

• WEBPRINTER_ACCESS_TOKEN

Команда установлена, но webprinter_mcp не найден

Обычно это означает, что директория Scripts Python не добавлена в 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