librus-mcp

Servidor MCP local y de solo lectura para una cuenta del Portal Librus. Utiliza el flujo de inicio de sesión del Portal para obtener un token de API de Librus de corta duración para una cuenta de Synergia elegida.

Modelo de seguridad

• Las credenciales se leen únicamente de LIBRUS_EMAIL y LIBRUS_PASSWORD.

• Las cookies y los tokens se mantienen en memoria y se descartan cuando el proceso finaliza o se llama a librus_logout.

• El servidor solo permite solicitudes HTTPS a portal.librus.pl y api.librus.pl.

• Expone una lista permitida de recursos de API de solo lectura; no puede enviar mensajes, marcar avisos como leídos ni enviar solicitudes arbitrarias.

• Deliberadamente no escribe ninguna solicitud, respuesta, credencial, token o payload de API en stdout/stderr. Stdout está reservado para el tráfico del protocolo MCP.

No pongas credenciales en package.json, en la configuración de MCP planificada en git controlado, ni en un archivo .env que esté bajo seguimiento.

Related MCP server: moodle-utn-mcp

Instalación y compilación

cd /home/xadix0wy/librus-mcp
npm install
npm run build

Configurar un host MCP

Usa variables de entorno en la configuración privada del host o en su almacén de secretos:

{
  "mcpServers": {
    "librus": {
      "command": "node",
      "args": ["/home/xadix0wy/librus-mcp/dist/index.js"],
      "env": {
        "LIBRUS_EMAIL": "your-email@example.com",
        "LIBRUS_PASSWORD": "your-password"
      }
    }
  }
}

LIBRUS_CLIENT_ID es opcional. El valor predeterminado es el ID de cliente público del flujo móvil heredado de Librus. No se trata como un secreto.

Herramientas

• librus_profiles: enumeras las cuentas de Synergia vinculadas a la cuenta del Portal.

• librus_get: lee calificaciones, asistencia, horario, tareas, avisos, información del colegio y otros recursos de API compatibles. Pasa account_login de librus_profiles.

• librus_logout: borra todo el material de autenticación en memoria.

El Portal puede requerir un reCAPTCHA o una acción de cuenta. En ese caso, el servidor se detiene con un error claro; completa la acción requerida directamente en https://portal.librus.pl o en la aplicación oficial y vuelve a intentarlo.

Compatibilidad

Esto depende de un flujo de Portal/API no documentado observado en el código fuente heredado de Szkolny Android. Librus puede modificarlo o restringirlo sin previo aviso. Está destinado únicamente al propietario de la cuenta y debe usarse de acuerdo con los términos de Librus y la política escolar.