MCP de Impresión en la Nube ZhiMu

webprinter_mcp es un servidor MCP para impresión en la nube. Si tu cliente MCP admite MCP de tipo stdio, puedes usarlo para cargar archivos, consultar impresoras, enviar tareas de impresión e imprimir directamente.

Qué puede hacer por ti

Puedes entenderlo como una "herramienta que te ayudará a gestionar tus tareas de impresión".

Por ejemplo, puedes decirle a una IA conectada a este MCP:

• "Ayúdame a ver si hay impresoras disponibles ahora"

• "Sube este archivo, prepáralo para imprimir"

• "Añade este archivo a la cola de impresión"

• "Imprime directamente en esa impresora de la oficina"

• "Cambia la tarea anterior a impresión a doble cara"

Preparación antes de usar

Primero debes instalar el servidor de impresión en la nube ZhiMu y completar el proceso de compartir la impresora. Obtén el paquete de instalación desde ZhiMu Cloud Printing:

• https://any.webprinter.cn

Luego, necesitas obtener un token de acceso para la impresión en la nube.

Dirección para obtenerlo:

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

Una vez obtenido el token, configura la variable de entorno:

• WEBPRINTER_ACCESS_TOKEN: Obligatorio

Instalación

Instalación mediante pip

pip install webprinter_mcp

O instalación desde el código fuente

pip install .

Cómo iniciar

Si solo quieres confirmar que se puede ejecutar localmente, puedes ejecutar:

webprinter_mcp

O:

python -m webprinter_mcp

Nota: Por lo general, este comando no mostrará mensajes de aviso al iniciarse. Entrará en un estado de espera para la conexión del cliente MCP, lo cual es normal.

Cómo configurar en un cliente MCP

Este proyecto es más adecuado para ser conectado mediante stdio.

Método Python local

Si ya has instalado este paquete en tu máquina, se recomienda configurarlo así:

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

Método npx

Si tu cliente admite el estilo npx, también puedes configurarlo así:

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

Nota: Si usas npx webprinter_mcp, aún necesitas tener un entorno de ejecución de Python disponible en tu máquina.

Sugerencias para la primera conexión

Al usarlo por primera vez, se recomienda seguir estos pasos:

Primero, verifica si tu cuenta actual cumple con las condiciones de impresión en la nube

Puedes entenderlo así:

• "Ayúdame a verificar si el entorno actual puede usar la impresión en la nube normalmente"

Si el resultado indica que el cliente o el dispositivo no están listos, completa primero la instalación y la configuración de uso compartido en WebPrinter.

Luego, deja que liste las impresoras disponibles actualmente

Puedes decir:

• "Ayúdame a ver qué impresoras hay disponibles"

Este paso generalmente devuelve:

• Nombre de la impresora

• Alias de la impresora

• Estado en línea

• ID del terminal de control

Si tienes archivos locales, súbelos primero

Puedes entenderlo como:

• "Sube este PDF local y dame una dirección imprimible"

Al depurar localmente, los parámetros comunes se ven así:

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

Luego decide entre "impresión en itinerancia" o "impresión directa"

Si solo quieres entrar en la cola de impresión, puedes entenderlo como:

• "Envía este archivo a impresión en itinerancia" o

• "Añade este archivo a la cola de impresión"

Si quieres imprimir inmediatamente en una impresora específica, puedes entenderlo como:

• "Imprime este archivo directamente en la impresora HP de la oficina"

Ejemplos de uso más coloquiales

Las siguientes frases son adecuadas para que este MCP las procese:

• "Ayúdame a comprobar si el entorno de impresión en la nube actual funciona"

• "Ayúdame a ver qué impresoras hay disponibles"

• "Sube el PDF que está en mi escritorio"

• "Añade esta página web a la cola de impresión"

• "Imprime directamente en la impresora de la recepción"

• "Cambia la tarea anterior a doble cara"

Preguntas frecuentes

¿Por qué no hay respuesta después de ejecutar webprinter_mcp?

Es normal. Después de iniciarse, esperará constantemente a que el cliente MCP se conecte a través de stdio, no imprimirá mucha información inmediatamente como las herramientas de línea de comandos comunes.

¿Qué hacer si al iniciar aparece un error relacionado con el token?

Por favor, ve aquí para obtener el token:

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

Luego confirma que has configurado:

• WEBPRINTER_ACCESS_TOKEN

El comando ya está instalado, pero no encuentra webprinter_mcp

Por lo general, es porque el directorio Scripts de Python aún no se ha añadido al PATH. En este caso, puedes usar directamente:

python -m webprinter_mcp

Herramienta de configuración de tareas

Para las tareas de impresión en itinerancia ya creadas, ahora puedes seguir modificando las siguientes configuraciones:

• update_printer_side(task_id, side)

• update_printer_color(task_id, color)

• update_printer_copies(task_id, copies)

• update_printer_paper(task_id, paper)

Descripción de parámetros

• task_id

  • ID de la tarea de impresión en itinerancia

• side

  • Valores opcionales: ONESIDE, DUPLEX, TUMBLE

  • Significan respectivamente: una cara, doble cara volteo por borde largo, doble cara volteo por borde corto

• color

  • Valores opcionales: COLOR, MONOCHROME

  • Significan respectivamente: color, blanco y negro

• copies

  • Entero

  • Debe ser mayor o igual a 1

• paper

  • Puedes pasar directamente el nombre del tipo de papel, como A3, A4, A5, LETTER

  • También puedes pasar un objeto personalizado: {"width": 210, "height": 297}

  • La unidad de ancho y alto es en milímetros

Ejemplos de uso

Si estás llamando a través de lenguaje natural en un cliente MCP, puedes decir:

• "Cambia la tarea 123 a impresión a doble cara"

• "Cambia la tarea 123 a impresión en blanco y negro"

• "Cambia la tarea 123 a 3 copias"

• "Cambia la tarea 123 a papel A4"

• "Cambia la tarea 123 a papel de 210 de ancho por 297 de alto"

Si estás depurando en la CLI local, puedes usarlo así:

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