[!IMPORTANT] Este proyecto no intenta eludir ni vulnerar la autenticación y las restricciones impuestas por D2L o SMU, sino que utiliza la API de D2L directamente tras realizar la autenticación adecuada mediante Chrome. Este proyecto no tiene ninguna vinculación con SMU ni con D2L. Si tienes algún problema, contacta conmigo directamente o crea un issue.

SMU eLearn MCP

Un servidor local y de solo lectura del Model Context Protocol para la implementación de D2L Brightspace de SMU. Expone cursos, cursos fijados, módulos semanales, documentos de curso, subidas/cambios recientes, búsqueda de contenido, metadatos y descargas de archivos.

Es un servicio stdio local y de un solo usuario. No está pensado para exponerse como servidor de red ni para compartirse entre usuarios.

La mejor forma de usar este MCP es a través de Codex o Claude, en los que lo he empaquetado como plugins instalables en la carpeta plugin-package/.

Capacidades

La implementación utiliza las rutas de API de solo lectura documentadas de D2L. No hace scraping de la página de inicio visible ni modifica cursos, estado de fijado, entregas, calificaciones, mensajes ni contenido.

Related MCP server: D2L Brightspace MCP Server

Requisitos

• Node.js 22 o superior

• Google Chrome

• Una cuenta SMU con acceso a eLearn

Instalación y autenticación

cd elearn-mcp
npm ci
npm run auth

npm run auth abre un perfil de Chrome dedicado. Completa el flujo normal de inicio de sesión de Microsoft y MFA de SMU. Tras un minuto, el comando comprueba automáticamente la API de eLearn; si el inicio de sesión aún está en curso, comprueba cada 15 segundos durante un máximo de cinco minutos. En caso de éxito, guarda el estado de sesión del navegador de Playwright, restringe el archivo de estado a permisos de solo propietario (0600) y cierra Chrome. No se requiere ninguna entrada de terminal.

El perfil usa ~/.elearn-mcp/browser-profile por defecto, y el estado guardado usa ~/.elearn-mcp/storage-state.json por defecto. El estado contiene cookies de sesión y puede contener almacenamiento web limitado al origen, así que trata ambas ubicaciones como secretos: no hagas commit de ellas, no las sincronices ni las compartas. El MCP nunca solicita ni almacena tu contraseña ni tu respuesta de MFA.

Verifica la seguridad de tipos, las pruebas unitarias y una compilación de producción limpia:

npm run check

Ejecuta la prueba MCP completa en vivo después de autenticarte:

npm run test:full

La ejecución completa realiza el typecheck y las pruebas unitarias, compila el servidor de producción, se conecta a través de MCP stdio, valida las once herramientas contra datos reales de eLearn, descarga un archivo real en un directorio temporal aislado del sistema operativo, verifica el archivo y elimina el directorio temporal en una limpieza con finally. Nunca envía ni modifica datos en eLearn.

Configuración del cliente MCP

Compila primero el proyecto y luego configura tu cliente MCP para iniciar el servidor stdio compilado:

{
  "mcpServers": {
    "smu-elearn": {
      "command": "node",
      "args": [
        "/absolute/path/to/elearn-mcp/dist/src/server.js"
      ],
      "env": {
        "ELEARN_BASE_URL": "https://elearn.smu.edu.sg",
        "ELEARN_LP_VERSION": "1.49",
        "ELEARN_LE_VERSION": "1.49",
        "ELEARN_COURSE_ORG_UNIT_TYPE_ID": "3"
      }
    }
  }
}

La ubicación exacta de este JSON depende del cliente MCP. Reinicia el cliente después de cambiar su configuración.

Entorno de ejecución en producción

El servidor se compila a partir del conjunto de dependencias bloqueadas. Las pruebas se someten al typecheck y se ejecutan durante la verificación, pero quedan excluidas de dist/ y del paquete distribuible.

Para un entorno de ejecución local mínimo:

npm ci
npm run check
npm prune --omit=dev
npm start

Después de eliminar las dependencias de desarrollo, ejecuta npm ci de nuevo antes de recompilar o ejecutar las pruebas unitarias. El flujo de trabajo de GitHub Actions incluido realiza la misma instalación bloqueada y verificación en Node.js 22. La prueba en vivo autenticada se mantiene fuera de CI porque requiere una cuenta SMU interactiva y MFA.

Compilar los plugins de Codex y Claude

Los archivos TypeScript en src/ son la única fuente de verdad de la implementación del MCP. Codex y Claude Code usan manifiestos de plugin y metadatos de lanzamiento de MCP separados, mientras que ambos reciben el mismo runtime generado:

plugin-package/
├── codex/smu-elearn/
│   ├── .codex-plugin/plugin.json
│   ├── .mcp.json
│   └── mcp/
└── claude/smu-elearn/
    ├── .claude-plugin/plugin.json
    ├── .mcp.json
    └── mcp/

Compila ambos paquetes de plugin nuevos y autocontenidos con:

npm run build:plugins

npm run build:plugin sigue siendo un alias del mismo comando. El proceso de compilación compila src/ una sola vez, obtiene las versiones exactas de las dependencias de producción a partir del lockfile raíz, instala las dependencias de producción una sola vez en un directorio de staging aislado y reemplaza cada directorio mcp/ solo después de que se haya verificado su copia completa en staging. No edites a mano ninguno de los runtimes generados.

Para el desarrollo con Claude Code, valida y carga el paquete directamente:

claude plugin validate ./plugin-package/claude/smu-elearn --strict
claude --plugin-dir ./plugin-package/claude/smu-elearn

Dentro de Claude Code, ejecuta /mcp para inspeccionar el servidor incluido. Para una instalación local persistente, compila los paquetes y luego añade el marketplace de este repositorio:

claude plugin marketplace add /absolute/path/to/elearn-mcp
claude plugin install smu-elearn@smu-local --scope user

El catálogo del marketplace se guarda en .claude-plugin/marketplace.json. Claude copia el paquete completo en su caché de plugins, por lo que el runtime mcp/ generado debe existir antes de la instalación. Usa --plugin-dir durante el desarrollo para evitar la caché y cargar el paquete in situ.

Configuración

Cómo se interpretan las semanas

• elearn_get_week_documents interpreta week como el módulo de contenido académico del curso, como Week 3. Incluye recursivamente los archivos de los submódulos anidados.

• elearn_get_recent_documents interpreta una semana como un rango de fechas del calendario y filtra por la LastModifiedDate de D2L del topic. Si se omiten since y until, usa el lunes a domingo locales de la semana actual.

Esta distinción es intencionada: un archivo guardado en «Week 3» puede haberse subido en una semana natural distinta.

Ciclo de vida de la autenticación

La herramienta MCP elearn_authenticate y el comando npm run auth lanzan el perfil de Chrome dedicado para el SSO y MFA controlados por el usuario. Esperan un minuto antes de la primera comprobación automática, sondean brevemente si es necesario, verifican la API de D2L y escriben un archivo storage-state de Playwright con permisos 0600. El servidor lanza un contexto de Chrome headless separado con ese estado y envía a través de él las peticiones de API del mismo origen. Esto preserva el control de SMU y Microsoft sobre la autenticación interactiva y, a la vez, permite que los procesos MCP se reinicien. Cuando expire la sesión institucional, llama a elearn_authenticate o vuelve a ejecutar npm run auth.

Consulta SECURITY.md para conocer el límite del despliegue local, las pautas de gestión de credenciales y las comprobaciones de release.