moodle-cli

Resumen

Un cliente de línea de comandos y servidor MCP para Moodle, construido sobre la API de web services en vez de scrapear HTML. Lista cursos, lee las secciones y actividades de una materia, descarga el material espejando la estructura de secciones y muestra quién está inscripto. El servidor MCP expone las mismas cuatro operaciones a un agente por stdio, con una diferencia deliberada: las descargas devuelven un manifiesto de rutas, tamaños y estado por archivo en lugar del contenido, porque una sola materia puede pesar cientos de megabytes que el agente puede leer del disco cuando los necesite.

Destacados

• Las descargas se verifican, no se asumen: Moodle responde algunos pedidos fallidos con HTTP 200 y un cuerpo JSON de error, que escrito a disco se convierte en un JSON chiquito con nombre de .pdf. Cada transferencia se chequea contra el tamaño y content type declarados.
• Las credenciales no pasan por la shell: la contraseña se pide por prompt, se canjea una vez por un token de larga duración y se guarda en el keyring del sistema. Los emails de participantes quedan ocultos salvo pedido explícito, tanto en el CLI como por MCP.
• Los tests unitarios corren offline contra fixtures sintéticos pero fieles en forma, que reproducen las rarezas de campus reales; una suite --live aparte detecta cuando un campus cambia su API por debajo.