Skip to main content
Glama
Brightspace Facultad MCP

Brightspace Facultad MCP

Brightspace Facultad MCP

Tests Python 3.11+ Licencia MIT

Consultá materias, actividades, consignas, noticias y materiales de Brightspace UADE desde un asistente MCP. Corre en tu computadora con tu cuenta y un Chromium dedicado, como Teams Facultad MCP, del que reutiliza infraestructura bajo licencia MIT.

Instalar con mi agente de IA · Descargar la última versión · Reportar un problema

Instalá con tu agente de IA

Pegá este prompt en un agente con acceso a la terminal de tu computadora (por ejemplo, Codex, Claude Code o Cursor):

Instalá y conectá el MCP local de este repositorio:
https://github.com/Matias-Sanmiguel/brightspace-facultad-mcp
Leé INSTALL_WITH_AI.md y seguí su prompt de instalación completo.
USE AT YOUR OWN RISK: acepto usar este proyecto bajo mi propia responsabilidad.
Prepará el entorno, ejecutá el instalador y configurá mi cliente MCP.
Yo voy a completar el inicio de sesión de UADE y MFA en el navegador dedicado.
Verificá el resultado y avisame si el cliente necesita reiniciarse.

El prompt completo incluye instalación por sistema, conservación de la configuración existente y comprobación de la conexión. Cada persona instala su copia e inicia sesión con su propia cuenta.

Related MCP server: canvas-session-mcp

Instalación

Necesitás Python 3.11+, Internet y un cliente MCP con transporte stdio.

Descargá brightspace-facultad-mcp-0.1.0-source.zip desde Releases y extraelo en una carpeta permanente. También podés clonar el repositorio:

git clone https://github.com/Matias-Sanmiguel/brightspace-facultad-mcp.git
cd brightspace-facultad-mcp

Abrí una terminal en esa carpeta y ejecutá los comandos de tu sistema:

Linux / macOS

sh install.sh
.venv/bin/python -m brightspace_facultad_mcp login

Windows — PowerShell

py -3 scripts/install.py
& .\.venv\Scripts\python.exe -m brightspace_facultad_mcp login

El instalador crea .venv, instala dependencias fijadas con hashes desde PyPI, descarga Chromium y genera mcp-config.json con las rutas de tu equipo. En Linux, si Playwright informa bibliotecas faltantes, seguí su diagnóstico de dependencias de sistema. Completá el ingreso y MFA de UADE en la ventana del navegador. Al confirmar la sesión, el comando cierra el navegador y libera el perfil para el MCP.

Copiá la entrada brightspace-facultad de mcp-config.json a tu cliente conservando sus otros servidores. Para Codex, el formato correspondiente es:

[mcp_servers.brightspace-facultad]
command = "/RUTA/brightspace-facultad-mcp/.venv/bin/python"
args = ["-m", "brightspace_facultad_mcp", "serve"]
startup_timeout_sec = 30
tool_timeout_sec = 180

[mcp_servers.brightspace-facultad.env]
BRIGHTSPACE_MCP_HEADLESS = "1"

En Windows, command termina en .venv\\Scripts\\python.exe; usá las rutas reales que genera config. Si el JSON incluye variables gráficas, trasladalas también al bloque env. Recargá los servidores o reiniciá el cliente. Configuración oficial de MCP en Codex.

Herramientas

Herramienta

Consulta

estado_conexion

Navegador y estado del ingreso; no abre Chromium por sí sola

iniciar_sesion

Abre el ingreso si el servidor funciona en modo visible

listar_materias

Cursos visibles en Mis cursos

listar_tareas

Actividades de una materia: estado, fecha original y puntuación visible

leer_tarea

Consigna y referencias a adjuntos; avisa si la actividad cerrada solo permite ver un resumen

leer_anuncios

Noticias de una materia y sus textos; predeterminado 10 por página

listar_archivos

Unidades, módulos y temas de Contenido

leer_documento

Texto de HTML, PDF, DOCX y PPTX, por fragmentos

Ejemplos:

Listá mis materias de Brightspace y las actividades de Aplicaciones Interactivas.

Leé la consigna de la actividad y las últimas dos noticias de la materia.

Buscá en los módulos el apunte de React y resumilo indicando la fuente.

Los IDs y cursores se obtienen de resultados anteriores y vencen al reiniciar. Usá materia_id al consultar tareas, noticias y materiales; carpeta_id permite entrar a un módulo. Si hay cursor, repetí la misma consulta con ese cursor. Las fechas se conservan como aparecen en la plataforma; no se inventan fechas para tareas que no las muestran.

Sesión local

El perfil se guarda fuera del proyecto, en el directorio de datos de tu usuario (~/.local/share/brightspace-facultad-mcp en Linux por defecto). Cada alumno instala su copia e ingresa con su propia cuenta. No se usa el perfil de Teams ni el navegador cotidiano. Un solo proceso puede usar el perfil a la vez.

El cliente usa BRIGHTSPACE_MCP_HEADLESS=1 para consultar sin ventana. Si la sesión vence, cerrá el cliente MCP, ejecutá login en una terminal gráfica y reabrí el cliente. El comando login necesita modo visible: no lo ejecutes con BRIGHTSPACE_MCP_HEADLESS=1. Para diagnóstico podés cambiar esa variable a 0. BRIGHTSPACE_MCP_DATA_DIR permite elegir un directorio de perfil independiente.

.venv/bin/python -m brightspace_facultad_mcp doctor
.venv/bin/python -m brightspace_facultad_mcp config

No compartas el perfil ni mcp-config.json. Los resultados enviados a tu asistente quedan sujetos a la configuración del cliente y su proveedor de IA.

Alcance

Las herramientas consultan: no envían mensajes, entregan trabajos ni responden cuestionarios. Abrir un tema puede actualizar el progreso de lectura y abrir noticias puede marcarlas como leídas. No se usan endpoints internos ni se interceptan tokens. Los enlaces de lectura se limitan a Brightspace UADE. Se comprueba el destino inicial y el final antes de devolver o procesar contenido. El navegador puede cargar recursos externos de una página y seguir redirecciones antes de que el conector rechace un destino inesperado; no es un aislamiento de red.

Mis cursos puede mostrar solo una selección de tus inscripciones. El listado inicial de Contenido combina módulos visibles y temas del módulo seleccionado; entrar a cada carpeta permite consultar sus materiales. El MCP indica listas parciales mediante completo, aviso y cursor. Una actualización de Brightspace puede requerir adaptar los selectores.

Los documentos admiten hasta 25 MiB y 10.000 caracteres por fragmento. PDF/DOCX/PPTX se procesan en un subproceso con límites y se borran los archivos temporales. No hay OCR ni extracción de audio, video, imágenes o diagramas; no se ejecutan archivos de código, ZIP ni RAR. Una lectura parcial del visor se identifica.

Desarrollo

.venv/bin/python -m pip install --require-hashes -r requirements-dev.lock
.venv/bin/python -m pytest -q
.venv/bin/python -m build
.venv/bin/python scripts/package.py

Las pruebas usan Chromium real sobre páginas sintéticas, sin iniciar sesión. El paquete de fuentes no contiene entorno virtual, perfiles ni documentos personales. Después de modificar el código instalado, ejecutá nuevamente scripts/install.py para actualizar el paquete de la instalación.

Verificación y límites · Licencia MIT. Proyecto independiente, sin afiliación con UADE ni D2L. Se ofrece tal cual, sin garantías; verificá fechas y entregas directamente en la plataforma.

Available Tools

8 tools
estado_conexionA
Read-only

Comprueba si el navegador está abierto y si Brightspace requiere autenticación.

Inputs: no named parameters. Returns: object

iniciar_sesionA

Abre un navegador dedicado para ingreso y MFA en modo visible. En modo sin ventana, usar login desde una terminal gráfica con el cliente MCP cerrado. Devuelve pronto; consultar estado_conexion después.

Inputs: no named parameters. Returns: object

leer_anunciosB
Read-only

Lee noticias visibles de la materia. Abrirlas puede marcarlas como leídas.

Inputs: materia_id (required), cursor, limite. Returns: object

leer_documentoA
Read-only

Lee páginas HTML y PDF/DOCX/PPTX (máximo 25 MiB) por fragmentos. No abre cuestionarios ni asignaciones como documentos. Sin OCR; el visor puede ser parcial.

Inputs: archivo_id (required), cursor, limite_caracteres. Returns: object

leer_tareaA
Read-only

Lee consigna, vencimiento, estado y materiales de un ID obtenido con listar_tareas.

Inputs: tarea_id (required). Returns: object

listar_archivosC
Read-only

Lista unidades, módulos y temas de Contenido. carpeta_id proviene de un listado anterior. Puede actualizar el progreso de lectura.

Inputs: materia_id (required), cursor, limite, carpeta_id. Returns: object

listar_materiasC
Read-only

Lista cursos visibles de Mis cursos con IDs opacos. Puede haber filtros; no garantiza todas las inscripciones.

Inputs: cursor, limite. Returns: object

listar_tareasA
Read-only

Lista actividades de una materia con estado y vencimiento original; usa leer_tarea para la consigna.

Inputs: materia_id (required), cursor, limite. Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a clearly distinct action or resource: connection status, login, course listing, task listing/reading, announcements, content listing, and document reading. The list/detail pairs (listar_tareas/leer_tarea, listar_archivos/leer_documento) have explicit boundaries, so an agent can select the right tool without ambiguity.

    Naming Consistency4/5

    Most tools follow a consistent Spanish snake_case verb_noun pattern (listar_materias, leer_tarea, iniciar_sesion). The only notable deviation is estado_conexion, which is noun-based rather than verb-based, but it remains readable and predictable within the set.

    Tool Count5/5

    Eight tools are well-scoped for a read-only Brightspace browsing client. Each tool earns its place by covering a distinct step in authentication, course discovery, and content reading without redundant surface area.

    Completeness3/5

    The set covers authentication, course listing, assignments, announcements, and content/document reading, but leaves notable LMS gaps such as grades, assignment submission, discussions, quizzes, and calendar workflows. Agents will encounter dead ends for common Brightspace tasks beyond read-only content browsing.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets AI assistants read a student's Canvas LMS/Moodle courses, deadlines, announcements, grades and course files using their normal browser login instead of an access token. It is read-only and keeps all session data and downloads on the user's own machine.
      36 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables an MCP-compatible assistant to log in with UNC single sign-on and explore the FCEFyN virtual classroom, listing enrolled courses, retrieving course indexes and materials, and reading or searching pages, activities, and PDFs. It works read-only with the user's own credentials, without tokens, admin permissions, or downloading entire courses.
      4
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables agents to query course information, announcements, assignments, and deadlines, and to download attachments, syllabus PDFs, and lecture videos through a local browser connection. It can also prepare assignment submissions for review without uploading by default.
      2
      -