Skip to main content
Glama

UNAHUR-MCP — El puente entre tu agente y el campus virtual de la UNAHUR.

NOTE

Basado en utn-mcp, de Joaquín Peñalva. Todo el trabajo y el mérito de este proyecto son suyos; este fork es solamente una adaptación al campus de la UNAHUR. Si estudiás en la UTN, usá el original. Si te gustó, dale una estrellita al original ❤️

Este es el Model Context Protocol server NO OFICIAL de la Universidad Nacional de Hurlingham. Con él podés pedirle a tu agente de preferencia (Claude, ChatGPT, etc.) que busque información y lea los apuntes del aula virtual y, con tu confirmación, que publique en los foros o entregue tareas. Corre en tu computadora o como servidor HTTP con OAuth, para usarlo desde cualquier lado.

Qué podés pedirle

  • "¿Cuándo es el recuperatorio del primer parcial de Álgebra?"

  • "¿Qué avisó la profesora de Física esta semana?"

  • "Resumime la guía de la unidad 3 de Sistemas Operativos."

  • "Pasame el link para bajar el apunte de calorimetría."

  • "¿Qué nota me pusieron en el TP1 y qué me corrigieron?"

  • "Preguntá en el foro de consultas si el parcial incluye la unidad 4."

  • "Anotame en el grupo 6."

  • "Agendame el recuperatorio del 14 a las 18."

El agente recorre el aula como lo harías vos: entra al curso, mira los foros y abre los archivos que hagan falta.

Related MCP server: moodle_mcp

Tools

Tool

Qué hace

aula_list_courses

Lista tus cursos. Es el punto de partida.

aula_open

Entra a un curso, un módulo, un foro o una discusión. Cada respuesta trae las direcciones de lo que hay adentro y de un nivel más arriba, así el agente navega sin perderse.

aula_read_file

Lee un archivo del aula, por partes cuando es largo.

aula_get_site_info

Datos de tu usuario y de tu campus en el aula virtual.

aula_forum_post

Abre un hilo en un foro o responde en una discusión.

aula_forum_edit_post

Edita una publicación tuya.

aula_forum_delete_post

Borra una publicación tuya.

aula_assign_submit

Entrega una tarea: sube archivos de tu compu, escribe el texto en línea y confirma el envío.

aula_assign_upload_link

Solo en modo HTTP: un link para subir los archivos de una entrega, que usa el agente con curl o vos desde el navegador.

aula_choice_answer

Responde una elección o te anota en un grupo.

aula_send_message

Manda un mensaje privado a un docente o compañero.

aula_calendar_add_event

Agrega un recordatorio a tu calendario del aula.

Al abrir una tarea, aula_open muestra si la entregaste, cuándo vence y la devolución con la nota. Las tools que escriben le piden al agente que te muestre lo que va a hacer y espere tu confirmación.

Archivos que puede leer

  • PDF: el texto, página por página. Los escaneados se mandan como imagen de cada página, y el agente los lee igual.

  • Word (.docx), PowerPoint (.pptx) y Excel (.xlsx): el texto, con las tablas fila por fila.

  • Imágenes (PNG, JPG, GIF) y texto plano.

Los formatos viejos de Office (.doc, .ppt, .pps), los comprimidos (.zip, .rar) y los videos no se leen. En ese caso el agente te pasa el link para que lo bajes.

Cada archivo viene con un link del aula virtual que podés abrir en tu navegador. Funciona con tu sesión del aula (si no estás logueado te manda al login) y nunca incluye tu token: ese queda siempre en tu computadora.

Cómo instalar

Necesitás Node.js 20 o superior. No hace falta clonar el repo ni instalar nada a mano: npx descarga el paquete solo.

1. Iniciar sesión

npx -y unahur-mcp login

Te pide tu campus, tu usuario y tu contraseña: los mismos con los que entrás al aula virtual. Se hace una sola vez: después el servidor renueva la sesión solo.

2. Agregarlo a tu cliente

Claude Code

claude mcp add unahur -- npx -y unahur-mcp

Claude Desktop: en Settings → Developer → Edit Config, agregá dentro de mcpServers:

"unahur": {
  "command": "npx",
  "args": ["-y", "unahur-mcp"]
}

En Windows, si no arranca, usá "command": "cmd" y "args": ["/c", "npx", "-y", "unahur-mcp"]. Después reiniciá Claude Desktop por completo.

Codex

codex mcp add unahur -- npx -y unahur-mcp

Gemini CLI

gemini mcp add unahur npx -y unahur-mcp

OpenClaw

openclaw mcp add unahur --command npx --arg -y --arg unahur-mcp

Hermes: en ~/.hermes/config.yaml:

mcp_servers:
  unahur:
    command: "npx"
    args: ["-y", "unahur-mcp"]

Cursor: en ~/.cursor/mcp.json:

{
  "mcpServers": {
    "unahur": { "command": "npx", "args": ["-y", "unahur-mcp"] }
  }
}

VS Code: en .vscode/mcp.json (o con MCP: Add Server desde la paleta de comandos):

{
  "servers": {
    "unahur": { "type": "stdio", "command": "npx", "args": ["-y", "unahur-mcp"] }
  }
}

ChatGPT: solo se conecta a servidores MCP remotos por HTTPS, así que necesita un servidor en modo HTTP publicado en internet (ver Hostearlo para otros). Se agrega como conector desde Configuración → Apps y conectores, con el modo desarrollador activado. Los conectores propios están desde el plan Pro, y ahí solo con las herramientas de lectura; para usar también las de escritura (foros, mensajes, entregas) hace falta Business o superior.

Otros clientes (Windsurf, opencode, etc.): cualquier cliente MCP que lance servidores por STDIO sirve con el comando npx -y unahur-mcp.

Instalación global (opcional)

Si preferís tener el comando unahur-mcp siempre disponible:

npm i -g unahur-mcp
unahur-mcp login

y en la config del cliente usás "command": "unahur-mcp" sin argumentos.

Campus

La UNAHUR tiene un campus virtual (Moodle) por año lectivo, campusAAAA.unahur.edu.ar. La lista se arma sola: va del año actual hasta 2023, el primero que existe, así que cada año aparece el campus nuevo sin actualizar nada. El campus se elige al iniciar sesión; viene marcado el del año. Campus 2026 ya está probado; los demás tienen habilitado el servicio que usa UNAHUR-MCP, así que casi seguro andan. Para cambiar de campus, volvé a correr login.

Al principio del año el campus nuevo puede no existir todavía: si el login falla con el que viene marcado, elegí el del año anterior.

Si querés usar un aula que no sigue ese formato, definila en un .env en la carpeta desde donde corrés unahur-mcp (o en el entorno) y aparece como una opción más al iniciar sesión:

UTN_AULA_BASE_URL=https://otra-aula.unahur.edu.ar

UTN_REGIONAL (por ejemplo, UTN_REGIONAL=2025) elige el que viene marcado por defecto, y es la que se usa si en lugar de login definís UTN_USER y UTN_PASS.

Modo HTTP (opcional)

Necesita Node 22.13 o más nuevo. Primero, una vez:

npx -y unahur-mcp login --http

Te muestra un token: configurá tu cliente MCP para que mande el header Authorization: Bearer <token>. Después:

npx -y unahur-mcp --http --port 3000

Levanta el servidor en http://127.0.0.1:3000/mcp, solo accesible desde tu propia máquina. Tenés que dejar la terminal abierta mientras lo uses.

En este modo el servidor no lee archivos de tu disco: para entregar, el agente pide un link con aula_assign_upload_link y sube ahí los archivos con curl si tiene terminal, o te pasa el link para que los elijas desde el navegador.

Hostearlo para otros

En modo HTTP el servidor también es servidor de autorización OAuth: un cliente MCP (Claude, ChatGPT) que se conecta a https://tu-dominio/mcp recibe un 401, descubre el OAuth y abre una página donde el alumno elige su campus y entra con su usuario de la UNAHUR. Cada alumno usa el campus que elige. Ese login vincula su aula: la contraseña se usa una sola vez para sacar el token de Moodle y no se guarda. Cuando la sesión del aula vence, el agente le pasa el link de /login para renovarla, sin reconectar el cliente.

Quién puede entrar lo decidís vos: con UTN_MCP_ALLOWED_EMAILS (una lista), o con UTN_MCP_ACCESS_URL, que apunta a un servicio tuyo. El servidor le hace POST con { "email", "usuario", "regional" } y el header Authorization: Bearer <UTN_MCP_ACCESS_SECRET>, y espera { "permitido": true } o { "permitido": false, "motivo": "...", "url": "..." }. Se consulta al conectar y en cada renovación del token (cada hora), así que una baja se aplica sola.

La configuración va en variables de entorno o en un .env en la carpeta desde donde lo corrés (copiá .env.example):

Variable

Para qué

Por defecto

HOST, PORT

Dónde escucha.

127.0.0.1, 3000

UTN_MCP_PUBLIC_URL

Dirección pública (https://mcp.tu-dominio.com). Es el issuer del OAuth, la base de los links de subida y el único host, además de localhost, que se acepta en Host y Origin.

http://127.0.0.1:<PORT>

UTN_MCP_ACCESS_URL, UTN_MCP_ACCESS_SECRET

Servicio que decide quién puede entrar.

—

UTN_MCP_ALLOWED_EMAILS

Emails o dominios (@unahur.edu.ar) habilitados, separados por coma, si no hay UTN_MCP_ACCESS_URL.

Entra cualquiera con usuario de la UNAHUR

UTN_MCP_REDIRECT_ALLOW

Hosts (app.ejemplo.com) o esquemas (miapp:) extra, separados por coma, a los que puede volver el login de OAuth. Loopback, Claude, ChatGPT, VS Code y Cursor pasan siempre. Cualquier otro host HTTPS (un agente propio, por ejemplo) se acepta, pero el login avisa a dónde vuelve y el alumno tiene que marcar que lo conecta bajo su responsabilidad: es la defensa contra alguien que use tu página de login para quedarse con su sesión. Los hosts de esta lista pasan sin aviso.

—

UTN_MCP_ADMIN_SECRET

Habilita la API de /admin para un panel de cuentas tuyo: POST /admin/usuarios (todos los usuarios con sus apps), /admin/clientes y /admin/clientes/revocar (las apps de un usuario, por email), /admin/regionales (los campus con su soporte) y /admin/verificar (entra al aula con usuario y contraseña, como el login de OAuth, y le guarda la sesión).

—

UTN_MCP_LOGIN_URL

Página donde el usuario renueva su sesión del aula; el agente se la pasa.

<UTN_MCP_PUBLIC_URL>/login

UTN_MCP_DB, UTN_MCP_KEY

Base de sesiones y su clave de cifrado (32 bytes en base64).

En la carpeta de config

Con Docker, detrás de un reverse proxy con HTTPS en la misma máquina (red host, para que el rate limit del login vea la IP real):

docker build -t unahur-mcp .
docker run -d --name unahur-mcp --network host --restart unless-stopped \
  -e HOST=127.0.0.1 -e PORT=8100 -e UTN_MCP_PUBLIC_URL=https://mcp.tu-dominio.com \
  -e UTN_MCP_KEY=$(openssl rand -base64 32) -v unahur-mcp-data:/data unahur-mcp

Guardá esa UTN_MCP_KEY: sin ella no se pueden descifrar las sesiones guardadas.

Dónde se guardan tus datos

Instalado en tu computadora, todo queda ahí:

  • Usuario y contraseña: en el gestor de credenciales del sistema (Windows Credential Manager, Keychain en macOS, Secret Service en Linux).

  • Token del aula virtual: en %APPDATA%\unahur-mcp\session.json (Windows) o ~/.config/unahur-mcp/session.json (Linux y macOS).

  • En modo HTTP: la contraseña no se guarda; la sesión va cifrada en unahur-mcp.db, en la misma carpeta, con la clave de store.key (o la de UTN_MCP_KEY). Del token del cliente solo se guarda el hash.

En Linux sin gestor de credenciales (servidores, Docker, WSL) podés definir las variables de entorno UTN_USER y UTN_PASS en lugar de usar login.

Si usás un servidor hosteado por otra persona, tu sesión del aula la guarda ese servidor (cifrada, y sin tu contraseña): revisá su política de privacidad.

Desarrollo

git clone https://github.com/franiiel/unahur-mcp.git
cd unahur-mcp
npm install
npm run login   # una vez
npm run dev     # servidor por STDIO desde src/, con tsx
npm run build   # compila a build/

pdf.js no es una dependencia del paquete publicado. Está como devDependency, y npm install corre el script prepare, que copia a vendor/pdfjs/ solo los archivos que usa el servidor (~4 MB). Así, quien instala unahur-mcp no baja pdf.js entero ni su canvas nativo opcional (~37 MB). Si instalaste con --ignore-scripts, generalo a mano con npm run prepare.

Aviso

Este proyecto no está afiliado ni avalado por la UNAHUR ni por la UTN. Está basado en utn-mcp, de Joaquín Peñalva (licencia ISC). Usalo bajo tu responsabilidad.

Available Tools

11 tools
aula_assign_submitA
Destructive

Entrega una tarea (assign) del aula virtual: sube archivos, escribe el texto en línea o las dos cosas, según lo que acepte la tarea. Antes, abrila con aula_open: entrega dice qué acepta (acepta, con tipos, cantidad y tamaño), si puedeEditar y lo que ya está subido.

Los archivos nuevos se pasan en archivos con su ruta absoluta en la compu del usuario. archivos es la lista final y reemplaza lo anterior: para sumar uno sin perder los otros, incluí la url de cada archivo que ya está en la entrega. Si no pasás archivos, quedan los que estaban; lo mismo con texto.

Si la tarea no usa borradores, guardar ya es entregar. Si los usa (requiereConfirmarEnvio), la tool además confirma el envío, salvo con enviar: false; una vez enviada, en general no se puede cambiar. Con declaracion, el usuario tiene que aceptarla (aceptoDeclaracion). Devuelve cómo quedó la entrega.

Antes de llamarla, mostrale al usuario exactamente lo que se va a hacer y esperá que confirme. Incluí la tarea, los nombres de los archivos y si se confirma el envío.

Inputs: direccion (required), texto, enviar, archivos, +1 more.

aula_calendar_add_eventA

Agrega un evento personal al calendario del aula virtual, que solo ve el usuario: por ejemplo un recordatorio de un parcial o una entrega. El aula avisa según la configuración de notificaciones del usuario. La fecha va con zona horaria; en Argentina es -03:00.

Inputs: inicio (required), nombre (required), descripcion, duracionMinutos.

aula_choice_answerA
DestructiveIdempotent

Responde una elección (choice: encuestas rápidas como "¿venís al parcial?") o una selección de grupos (choicegroup: anotarse en un grupo o comisión). Deja elegidas exactamente las opciones pasadas y reemplaza la respuesta anterior; con una lista vacía la borra.

Las opciones salen de eleccion al abrir el módulo con aula_open. Muchas no dejan cambiar la respuesta una vez dada (puedeCambiar: false), y las opciones deshabilitada están completas. Devuelve cómo quedó la elección.

Antes de llamarla, mostrale al usuario exactamente lo que se va a hacer y esperá que confirme.

Inputs: opciones (required), direccion (required).

aula_forum_delete_postA
DestructiveIdempotent

Borra una publicación propia de un foro. No se puede deshacer. Solo se puede si tiene "borrar" en acciones. Si es la primera publicación de la discusión, se borra la discusión entera.

Antes de llamarla, mostrale al usuario exactamente lo que se va a hacer y esperá que confirme.

Inputs: id (required), direccion (required).

aula_forum_edit_postA
DestructiveIdempotent

Edita una publicación propia de un foro y reemplaza el mensaje completo. Solo se puede si la publicación tiene "editar" en acciones: Moodle deja editar por un rato después de publicar.

Antes de llamarla, mostrale al usuario exactamente lo que se va a hacer y esperá que confirme.

Inputs: id (required), mensaje (required), direccion (required), asunto.

aula_forum_postA

Publica en un foro del aula virtual. Con la direccion de un foro abre un hilo nuevo (hace falta asunto); con la de una discusión responde en ella, a la publicación respuestaA o, si no se indica, a la primera.

Lo que se publica lo ven docentes y compañeros, y a muchos les llega por mail. Antes de abrir un hilo, mirá puedeAbrirHilo del foro; antes de responder, que la publicación tenga "responder" en acciones.

Antes de llamarla, mostrale al usuario exactamente lo que se va a hacer y esperá que confirme.

Inputs: mensaje (required), direccion (required), asunto, respuestaA.

aula_get_site_infoA
Read-only

Datos del usuario logueado y del sitio Moodle de su aula virtual. regional es el campus de la UNAHUR de esa aula (por ejemplo, "Campus 2026"): cada año lectivo tiene su propio campus.

Inputs: no named parameters.

aula_list_coursesA
Read-only

Lista los cursos (materias) en los que está inscripto el usuario. Es el punto de entrada: cada curso viene con su direccion, que se le pasa a aula_open para entrar.

Inputs: no named parameters.

aula_openA
Read-only

Entra a una dirección del aula virtual y devuelve lo que hay ahí: un curso con sus secciones y módulos, un módulo con sus archivos y fechas, un foro con el índice de sus discusiones, o una discusión con sus mensajes completos.

Según el tipo de módulo trae además: en una tarea (assign), entrega con el estado, el vencimiento, lo que se subió y la devolución con la nota; en una elección (choice) o selección de grupos (choicegroup), eleccion con las opciones y sus ids; en un foro, puedeAbrirHilo; en una discusión, el id, el autorId y las acciones permitidas de cada publicación. Es lo que piden las tools que escriben en el aula.

No hace falta armar la dirección: cada respuesta trae las direcciones de lo que hay adentro (direccion) y la de un nivel más arriba (padre), así que se navega pasando de vuelta una de esas. Para empezar, usar aula_list_courses o la dirección "/".

Buscar algo que puede estar en cualquier parte (una fecha de parcial, un aviso) se hace entrando al curso y abriendo lo que corresponda: el índice de un foro muestra los asuntos sin volcar los mensajes enteros, y archivos como un cronograma se leen con aula_read_file.

Los archivos vienen con una url, que sirve para leerlos con aula_read_file y también para dársela al usuario si quiere bajarlo: se abre con su sesión del aula.

Inputs: direccion (required), pagina.

aula_read_fileA
Read-only

Lee un archivo del aula virtual: PDF, Word (docx), PowerPoint (pptx), Excel (xlsx), imágenes y texto. Los PDF escaneados se devuelven como imagen de cada página.

Devuelve el archivo por partes (páginas, diapositivas o fragmentos), tantas como entren en una respuesta. Si quedan más, siguiente dice desde cuál pedir; también se puede saltar directo a una parte con desde.

Formatos que no sabe leer (.doc, .ppt viejos, .zip, .rar, videos): devuelve un error con la URL para que el usuario lo baje.

Inputs: url (required), desde.

aula_send_messageA

Manda un mensaje privado por la mensajería del aula virtual a otro usuario, docente o compañero. El usuarioId sale del autorId de un foro o una discusión abiertos con aula_open: no lo inventes ni lo deduzcas del nombre. La respuesta trae el nombre del destinatario.

Antes de llamarla, mostrale al usuario exactamente lo que se va a hacer y esperá que confirme. Incluí a quién va dirigido.

Inputs: mensaje (required), usuarioId (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 11 tools

    Disambiguation4/5

    Each tool targets a distinct action: navigation (aula_open, aula_list_courses), reading (aula_read_file, aula_get_site_info), forum CRUD, submission, choice answers, messaging, and calendar. The only mild overlap is that aula_open can open a course while aula_list_courses lists enrolled courses and '/'-navigation is shared, but descriptions make the roles clear. No two tools appear to do the same thing.

    Naming Consistency4/5

    All tools share the 'aula_' prefix and snake_case, and resource-scoped write tools (aula_forum_post, aula_forum_edit_post, aula_assign_submit, aula_choice_answer) form coherent families. However ordering is mixed: read tools use verb_noun (get_site_info, list_courses, read_file) while writes use noun_verb, and aula_open is a bare verb — a minor structural deviation but still predictable.

    Tool Count5/5

    11 tools is well within the ideal 3-15 range and every tool earns its place: navigation, reading, forum lifecycle, submission, choice, messaging, and calendar. No redundant or filler tools.

    Completeness4/5

    Covers the core student workflow end-to-end: discovery, navigation, file reading, forum CRUD, assignment submission, choice/group answers, private messaging, and calendar reminders. Minor gaps remain — messaging is send-only (no inbox read) and calendar is add-only (no edit/delete) — but these are workable around.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers