Skip to main content
Glama

UTN FRSF · Campus Virtual MCP

Un servidor MCP para conectar asistentes de inteligencia artificial con el Campus Virtual de la UTN Facultad Regional Santa Fe.

Su objetivo es facilitar las tareas cotidianas del estudiante desde un asistente, usando su cuenta del campus.

Proyecto en desarrollo. Incluye inicio de sesión, consulta mensual de actividades y listado de enlaces por asignatura y flujo de carga/entrega de tareas. La carga y entrega se verificaron en una tarea real autorizada.

login() usa las credenciales del .env privado. list_monthly_activities() devuelve JSON con las fechas, horarios, asignaturas y enlaces directos de las actividades del calendario. Podés probarlas en Inspector siguiendo la guía de desarrollo. Los parámetros y ejemplos de la consulta mensual están en su guía.

list_courses() devuelve las materias visibles en Grado, con ID, nombre y enlace, incluidos años anteriores. Permite encontrar la materia antes de consultar recursos o entregas. Ver alcance y verificación.

get_course_resources(course_id) lista los enlaces de una materia, incluidas tareas, archivos y materiales de carpetas. Recorre secciones y devuelve el alcance de la consulta. Ver uso y límites; verificada en Análisis Numérico (topics); queda pendiente la validación integral de onetopic.

get_section_content(course_id, section), get_page_content(course_id, module_id) y get_folder_content(course_id, module_id) leen como Markdown el texto publicado en secciones, páginas y descripciones de carpetas, incluidas tablas como los cronogramas.

download_resources(course_id, module_id, urls) descarga archivos de cualquier tipo del módulo indicado a downloads/, valida la transferencia y devuelve rutas, tamaños y hashes. Ver uso y límites.

get_server_info() indica qué herramientas están verificadas en el campus, cuáles solo parcialmente y cuáles tienen solo pruebas locales, con sus límites conocidos.

get_assignment_feedback() muestra la devolución del docente en una tarea: nota, fecha, quién corrigió, comentarios y archivos devueltos.

get_submission_status() consulta una tarea; prepare_submission() valida archivos localmente; upload_files() los carga a un área temporal; submit_assignment() guarda y, opcionalmente, finaliza la entrega. Ver contrato y verificación. La carga y el guardado se verificaron mediante MCP en el TP 6 de Análisis Numérico, con estado final enviado y comprobación de los bytes.

Funciones previstas

  • Consultar materias, actividades y consignas.

  • Revisar fechas de entrega y eventos del calendario.

  • Descargar bibliografía, apuntes y otros materiales.

  • Enviar trabajos prácticos, consultar el estado de las entregas y leer sus devoluciones.

Related MCP server: cvuex-mcp

Cómo funciona

El asistente recibe un pedido en lenguaje natural, como “¿qué trabajos vencen esta semana?” o “descargá la bibliografía de esta materia”. A través de MCP, solicita las acciones necesarias al servidor.

El servidor utiliza Lightpanda, un navegador que funciona en segundo plano, para acceder al campus, consultar información o realizar la acción solicitada. Luego devuelve el resultado al asistente.

El acceso se limita a las materias y recursos disponibles para la cuenta del estudiante.

Estructura

src/utnfrsf_campus_mcp/
├── server.py       # Arranque del servidor MCP.
├── config.py       # Configuración desde .env y variables de entorno.
├── models.py       # Modelos de datos.
├── browser/        # Integración con Lightpanda.
├── parsers/        # Extracción de información del campus.
├── services/       # Lógica de las funcionalidades.
└── tools/          # Herramientas expuestas al asistente.
docs/               # Documentación de desarrollo.
examples/           # Ejemplos de configuración MCP.
.env.example        # Plantilla de configuración local.
pyproject.toml      # Paquete y dependencias.
uv.lock             # Versiones de dependencias.
roadmap.md          # Plan de implementación.
AGENTS.md           # Guía para agentes de desarrollo.

Documentación técnica: desarrollo local · roadmap · análisis y funcionalidades pendientes.

Licencia

MIT. Proyecto independiente, sin afiliación oficial con la UTN.

Available Tools

10 tools
download_resourcesA

Descarga entre 1 y 10 archivos del campus a downloads/course-ID/module-ID/.

Verifica su pertenencia al módulo y a la materia con una consulta autenticada nueva. Usa la sesión de Lightpanda y un transporte HTTP binario del mismo origen. Valida respuesta HTTP y tamaño; calcula SHA-256 y detecta páginas de login/error de Moodle. Admite cualquier extensión y MIME; no valida el formato interno ni ejecuta archivos. No sigue redirecciones ni reemplaza archivos existentes. Devuelve rutas locales, tamaños, hashes y fallos por archivo. Solo archivos del campus, sin destinos externos. No modifica entregas del campus.

Inputs: urls (required), course_id (required), module_id (required). Returns: files, course, complete, failures, +1 more

get_course_resourcesA
Read-onlyIdempotent

Lista los enlaces de una asignatura, incluidas tareas y archivos PDF, ZIP y otros.

Recorre secciones topics/onetopic accesibles; lee carpetas, recursos, enlaces URL, páginas y adjuntos de consignas de tareas. Devuelve links con sección, módulo y source_url. Los enlaces de tareas abren la actividad de entrega; no envía archivos. Autentica con .env. No visita sitios externos ni descarga binarios. Solo contenido visible para la cuenta: no inventa enlaces de actividades o secciones restringidas. Revisá complete, pending_urls y warnings antes de asumir que el inventario es completo. No recorre conversaciones de foros, intentos de exámenes ni sitios externos.

Inputs: course_id (required). Returns: Inventario de enlaces del curso y alcance efectivo de la consulta.

get_server_infoA
Read-onlyIdempotent

Consulta versión, zona horaria y el estado real de cada herramienta registrada.

No abre Lightpanda ni verifica la sesión del campus. Cada elemento de capabilities indica efecto (none, local, read, write), nivel de evidencia (local_tests, campus_partial, campus_verified), fecha de verificación real, alcance, límites pendientes, IDs relacionados del inventario y documentación. undocumented_tools lista herramientas registradas sin estado declarado.

Inputs: no named parameters. Returns: Información pública del servidor, sin probar acceso al campus.

get_submission_statusB
Read-onlyIdempotent

Consulta estado y archivos de una tarea assign, conservando la evidencia original.

Inputs: course_id (required), activity_id (required). Returns: name, files, state, can_edit, +4 more

list_coursesA
Read-onlyIdempotent

Lista las materias visibles en My courses → Grado, con ID, nombre completo y URL.

Sin parámetros. Autentica con la configuración privada de .env y comparte la sesión de Lightpanda con las demás herramientas. Incluye Sistemas y Básicas y todos los años presentes en esa rama; excluye Ingreso, Extensión y el catálogo general. Devuelve scope=Grado, source_url, fetched_at, total, courses y complete=true. Una rama pendiente, un límite o un fallo de sesión/parsing producen un error MCP, nunca una lista vacía exitosa. No abre cada materia ni modifica datos académicos. Los nombres parecidos se devuelven como materias distintas con sus respectivos IDs.

Inputs: no named parameters. Returns: Materias visibles en Grado; una extracción incompleta produce un error.

list_monthly_activitiesA
Read-onlyIdempotent

Lista en JSON las actividades del calendario mensual de todas las asignaturas.

Omití year y month para consultar el mes actual en la zona del campus, o indicá ambos. Incluye nombre, asignatura, fechas ISO 8601 con hora y offset, y activity_url directo. deadline_at solo se completa para due/close; aperturas y asistencias conservan su tipo. No confirma entregas pendientes. Autentica con .env y consulta solo eventos visibles para la cuenta y sus filtros de calendario. No depende del idioma de la interfaz.

Inputs: year, month, deadlines_only. Returns: Calendario del mes visible para la cuenta; no confirma el estado de entrega.

loginA

Inicia sesión en UTN FRSF con las credenciales locales de .env.

Conserva la sesión durante la ejecución del servidor. Reintenta TooManyRequests de forma acotada, volviendo a la página de acceso.

Inputs: no named parameters. Returns: Confirmación de sesión; no contiene identidad, tokens ni credenciales.

prepare_submissionB
Read-onlyIdempotent

Prepara archivos y hashes localmente; no inicia sesión ni escribe en el campus.

Inputs: files (required), course_id (required), activity_id (required). Returns: files, course_id, activity_id

submit_assignmentA

Guarda la carga del recibo como entrega y verifica el resultado en el campus.

Guardar puede entregar definitivamente si la actividad no utiliza borradores. finalize=true completa además la confirmación de envío cuando exista. Una declaración de autoría requiere accept_statement=true explícito. No reemplaza entregas existentes ni reenvía POSTs de resultado incierto. Solo invocar para una entrega autorizada con esos archivos y destino; upload_files por sí sola no autoriza este guardado.

Inputs: upload_id (required), finalize, accept_statement. Returns: stage, status, message, upload_id, +1 more

upload_filesA

Carga y verifica archivos en el área temporal de una tarea abierta; devuelve un recibo.

Respeta los tipos, tamaños y cantidad admitidos por la actividad. Admite archivos de cualquier tipo permitido, incluidos ZIP; rechaza carpetas y reemplazos de entregas. No guarda ni envía la entrega. El recibo dura 30 minutos en este proceso MCP.

Inputs: files (required), course_id (required), activity_id (required). Returns: files, stage, limits, message, +4 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools target distinct resources and actions, and the submission pipeline (prepare_submission → upload_files → submit_assignment) is explicitly delineated, with descriptions stating that upload alone does not submit and prepare doesn't touch the campus. The only mild overlaps are download_resources vs get_course_resources (list links vs fetch binaries) and prepare_submission vs upload_files, both of which are clarified in the descriptions.

    Naming Consistency4/5

    All names are snake_case and almost all follow a verb_noun pattern (list_courses, get_course_resources, download_resources, submit_assignment). The single outlier is the bare verb 'login' with no object, which is a minor, natural deviation and does not harm readability.

    Tool Count5/5

    Ten tools is squarely in the well-scoped range, and each one earns its place: session setup, course/calendar inventory, resource discovery and download, plus a four-step staged submission workflow. There is no filler or redundancy.

    Completeness4/5

    The surface covers the core lifecycle: login, list courses, discover resources, download files, read calendar deadlines, and a full prepare/status/upload/submit pipeline with verification. Minor gaps exist — no logout/session-state tool beyond get_server_info, no grades or notification/announcement retrieval, and no assignment-detail lookup — but these are described as intentional scope limits rather than dead ends for the main workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to query the UEx virtual campus (CVUEx/AVUEx) in natural language, including deadlines, grades, announcements, forums, and course materials, using the user's own account with read-only access.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI tools to read course materials, links, and deadlines from a student's university learning platform, and to download lecture slides into course folders for SlideMate and other MCP clients.
      8
      2
      MIT