tuaulavirtual-unam-mcp
Allows interaction with the Moodle virtual classroom (UNAM), providing tools to list courses, retrieve course contents and assignments, download files from the platform, fetch web pages, and upload or submit assignments.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tuaulavirtual-unam-mcp @tuaulavirtual-unam-mcp what assignments are due this week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tuaulavirtual-unam-mcp
Servidor MCP para el aula virtual Moodle de la UNAM
(tuaulavirtual.educatic.unam.mx). Permite que Claude Code, Claude Desktop, Cursor
o cualquier cliente MCP consulte tus cursos, tareas, fechas de entrega, descargue
materiales y, si se lo pides, entregue tareas por ti.
Usa la API REST oficial de Moodle (servicio moodle_mobile_app) y, como respaldo,
una sesión web para leer páginas que la API no cubre.
Requisitos
uv instalado. En macOS:
brew install uv. En cualquier sistema:curl -LsSf https://astral.sh/uv/install.sh | sh.Tu usuario y contraseña del aula virtual.
Related MCP server: Moodle MCP Server
Instalación en 2 pasos
1. Guarda tus credenciales (se piden de forma interactiva y quedan en
~/.config/tuaulavirtual-unam-mcp/.env con permisos solo para tu usuario):
uvx --from git+https://github.com/AlanMagno1/tuaulavirtual-unam-mcp tuaulavirtual-unam-mcp setup2. Registra el servidor en Claude Code:
claude mcp add tuaulavirtual-unam -s user -- uvx --from git+https://github.com/AlanMagno1/tuaulavirtual-unam-mcp tuaulavirtual-unam-mcpListo. Abre Claude Code y pídele, por ejemplo:
¿Qué tareas tengo pendientes?
Revisa https://tuaulavirtual.educatic.unam.mx/mod/assign/view.php?id=469144 y dime qué piden.
Otros clientes (Claude Desktop, Cursor, etc.)
Agrega esto a la configuración JSON de servidores MCP del cliente:
{
"mcpServers": {
"tuaulavirtual-unam": {
"command": "uvx",
"args": ["--from", "git+https://github.com/AlanMagno1/tuaulavirtual-unam-mcp", "tuaulavirtual-unam-mcp"]
}
}
}Variables de entorno (alternativa al archivo de configuración)
Variable | Descripción |
| URL del Moodle. Default: |
| Usuario del aula virtual |
| Contraseña |
| Carpeta de descargas. Default: |
| Carpeta de configuración. Default: |
Las variables de entorno tienen prioridad sobre el archivo .env. Funciona con
cualquier Moodle que tenga habilitado el servicio móvil, cambiando MOODLE_URL.
Otros Moodle de la UNAM (CUAED, idiomas, etc.)
El mismo servidor sirve para cualquier Moodle con el servicio móvil habilitado. Al
correr setup, escribe la URL del Moodle en la primera pregunta en vez de aceptar
la default. URLs verificadas:
Aula | URL para |
Tu Aula Virtual (default) |
|
Aulas Virtuales CUAED |
|
Ambiente Virtual de Idiomas |
|
Ojo: aulas-virtuales.cuaed.unam.mx (con guion) es solo el portal informativo; el
Moodle de CUAED está en la URL de la tabla. En CUAED el login web está desactivado,
así que la herramienta fetch_page no funciona ahí; las demás sí.
Dos o más aulas a la vez
Cada aula necesita su propia carpeta de configuración y su propio nombre de servidor.
setup avisa si vas a sobrescribir una configuración existente. Ejemplo para agregar
CUAED junto a Tu Aula Virtual:
# 1. Credenciales de CUAED en una carpeta aparte
TUAULAVIRTUAL_MCP_CONFIG_DIR=~/.config/cuaed-mcp \
uvx --from git+https://github.com/AlanMagno1/tuaulavirtual-unam-mcp tuaulavirtual-unam-mcp setup
# 2. Segundo servidor en Claude Code
claude mcp add cuaed-unam -s user -e TUAULAVIRTUAL_MCP_CONFIG_DIR=$HOME/.config/cuaed-mcp -- \
uvx --from git+https://github.com/AlanMagno1/tuaulavirtual-unam-mcp tuaulavirtual-unam-mcpClaude verá las herramientas de ambos servidores con prefijos distintos y elegirá el correcto según el aula o la URL que menciones.
Herramientas
Herramienta | Qué hace |
| Verifica la conexión y devuelve el usuario autenticado. |
| Cursos en los que estás inscrito. |
| Secciones y módulos de un curso, con fechas y archivos. |
| Detalle de una tarea: instrucciones, fechas, adjuntos y estado de tu entrega. Acepta la URL completa |
| Descarga un archivo a |
| Inicia sesión por web y devuelve el texto de cualquier página del aula. |
| Sube un archivo local al área de borradores; devuelve |
| Guarda una entrega (texto en línea y/o archivos) y opcionalmente la envía para calificación. |
Comandos
tuaulavirtual-unam-mcp setup # captura credenciales y prueba la conexión
tuaulavirtual-unam-mcp check # imprime el usuario autenticado
tuaulavirtual-unam-mcp # arranca el servidor MCP por stdio (lo usa el cliente)Seguridad
Tus credenciales nunca salen de tu máquina: solo se envían a la URL del Moodle configurada, para obtener un token del servicio móvil.
El token se guarda en
~/.config/tuaulavirtual-unam-mcp/token.json(permisos 600) y se renueva automáticamente si Moodle lo invalida.submit_assignmententrega tareas en tu nombre. Claude solo debe usarla cuando se lo pidas explícitamente.
Desarrollo
git clone https://github.com/AlanMagno1/tuaulavirtual-unam-mcp
cd tuaulavirtual-unam-mcp
uv sync
uv run tuaulavirtual-unam-mcp checkPara probar cambios locales en Claude Code sin publicar:
claude mcp add tuaulavirtual-unam -s user -- uv --directory /ruta/a/tuaulavirtual-unam-mcp run tuaulavirtual-unam-mcpLicencia
MIT
Available Tools
8 toolsdownload_fileB
Descarga un archivo de Moodle (fileurl devuelto por otras herramientas) al disco y devuelve la ruta local. Usa luego la herramienta Read para leerlo.
Inputs: fileurl (required), filename. Returns: result
fetch_pageA
Inicia sesión por web y devuelve el texto visible de cualquier página del aula virtual (útil para lo que la API no cubre: foros, calificaciones, avisos...).
Inputs: url (required). Returns: result
get_assignmentA
Detalle de una tarea (mod/assign): descripción, fechas, archivos adjuntos y estado de la entrega del usuario. Acepta el cmid numérico o la URL completa (https://.../mod/assign/view.php?id=NNN).
Inputs: cmid_or_url (required).
get_course_contentsA
Devuelve las secciones y módulos (tareas, recursos, foros...) de un curso.
Inputs: course_id (required). Returns: result
get_site_infoB
Verifica la conexión y devuelve datos del sitio y del usuario autenticado.
Inputs: no named parameters.
list_coursesA
Lista los cursos en los que está inscrito el usuario.
Inputs: no named parameters. Returns: result
submit_assignmentA
Guarda una entrega en una tarea: texto en línea, archivos (itemid de upload_file) o ambos. Si submit_for_grading=True, además la envía para calificación (acepta la declaración de autoría). Úsala solo cuando el usuario lo pida explícitamente.
Inputs: cmid_or_url (required), online_text, files_itemid, submit_for_grading.
upload_fileA
Sube un archivo local al área de borradores del usuario y devuelve el itemid del borrador, que se usa en submit_assignment(files_itemid=...).
Inputs: path (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Cada herramienta tiene un propósito claramente delimitado: listar cursos, obtener contenidos, ver detalle de una tarea, transferir archivos y enviar entregas. Aunque fetch_page podría usarse para ver una tarea, su descripción la limita explícitamente a lo que la API no cubre, evitando solapamientos reales.
Todos los nombres siguen un patrón verb_noun en snake_case (list_courses, get_assignment, upload_file, submit_assignment). Los verbos reflejan claramente la acción y no hay mezcla de estilos ni nombres vagos.
Ocho herramientas es un tamaño adecuado para un cliente de aula virtual centrado en consultar cursos, tareas y gestionar entregas. El conjunto no se siente ni inflado ni demasiado escaso para su propósito.
El flujo principal está bien cubierto: ver cursos y contenidos, consultar tareas, descargar archivos, subir borradores y enviar entregas. La falta de herramientas estructuradas para foros, calificaciones o avisos se mitiga con fetch_page, pero sigue siendo un vacío menor respecto a un acceso totalmente especializado.
Maintenance
Related MCP Connectors
PLATO (Pusan National University LMS) MCP server via Moodle Web Service API + ubboard scraping
Manage your Canvas coursework with quick access to courses, assignments, and grades. Track upcomin…
Run the Geduk LMS from an AI assistant: courses, sessions, enrolments, users and catalogue.
Study from your own classes: synced Canvas coursework, notes, flashcards and study progress.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Moodle learning management systems through the Moodle REST API. Supports course management, user enrollment, assignments, forums, quizzes, and file operations through natural language.MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Moodle learning management systems through the REST API. Supports course management, user enrollment, assignment handling, and forum operations through natural language.MIT
- AlicenseNot gradedqualityBmaintenanceConnects AI agents to Argentine universities' Moodle virtual classrooms and SIU Guaraní self-service portals, enabling them to read course materials, announcements, grades, and enrollment data. With user confirmation it can also post to forums, submit assignments, answer choices, and send private messages.340 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to access Moodle virtual classrooms and SIU Guaraní for Argentine universities, including reading course materials, searching discussions, checking grades and academic status, and, with confirmation, posting to forums or submitting assignments.MIT