MCP-TUPAD

Servidor MCP para consultar el campus virtual Moodle de la Tecnicatura Universitaria en Programación a Distancia (UTN) desde cualquier asistente de IA.

Conecta tu cuenta del campus con Claude Code, Claude Desktop, Cursor, VS Code o cualquier otro cliente compatible con MCP, para que puedas preguntar cosas como:

¿Qué se me vence esta semana? Explicame el apunte de la unidad 3 de Programación I. ¿Cómo vengo de notas en Matemática? ¿Hay avisos nuevos de los profesores?

Cómo funciona

Moodle expone una API REST oficial (la misma que usa su app móvil). Este servidor la traduce a herramientas MCP. Cada persona usa su propio token, y solo accede a lo que ya ve en el campus con su usuario.

No requiere permisos de administrador ni instalar nada en el servidor de la UTN.

Requisitos

• Node.js 20.12 o superior (node --version para verificar)
• Una cuenta del campus con usuario y contraseña propios de Moodle

Instalación

1. Clonar e instalar

git clone https://github.com/brujoh88/MCP-TUPAD.git
cd MCP-TUPAD
npm install

2. Obtener tu token

Ejecutá esto reemplazando tus credenciales:

curl -s "https://tup.sied.utn.edu.ar/login/token.php" \
  -d "username=TU_USUARIO" \
  -d "password=TU_CONTRASENA" \
  -d "service=moodle_mobile_app"

Devuelve algo así:

{ "token": "a1b2c3d4e5f6..." }

⚠️ Ese token equivale a tu contraseña. Quien lo tenga puede entregar trabajos prácticos y publicar en foros en tu nombre. Nunca lo compartas ni lo subas a un repositorio — cada compañero saca el suyo con sus credenciales.

3. Configurar

cp .env.example .env

Abrí .env y pegá tu token:

MOODLE_URL=https://tup.sied.utn.edu.ar
MOODLE_TOKEN=a1b2c3d4e5f6...

El archivo .env está en .gitignore, así que nunca se sube al repo.

4. Verificar que funcione

npm run probar-token

Deberías ver tu nombre y el listado de tus materias con sus IDs. Si esto falla, el problema está en el token o la URL — no en el MCP.

Conectarlo a tu cliente

El servidor es el mismo para todos los clientes; solo cambia dónde va la configuración.

Claude Code

Si abrís este proyecto, ya está: el archivo .mcp.json del repo se detecta solo y Claude Code te pide aprobarlo al iniciar.

Para usarlo desde cualquier proyecto, registralo a nivel usuario:

claude mcp add --scope user --transport stdio moodle-tupad \
  -- node /ruta/absoluta/a/MCP-TUPAD/src/index.js

Cursor

Creá ~/.cursor/mcp.json (global) o .cursor/mcp.json (solo este proyecto):

{
  "mcpServers": {
    "moodle-tupad": {
      "command": "node",
      "args": ["/ruta/absoluta/a/MCP-TUPAD/src/index.js"]
    }
  }
}

Claude Desktop

Editá claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "moodle-tupad": {
      "command": "node",
      "args": ["/ruta/absoluta/a/MCP-TUPAD/src/index.js"]
    }
  }
}

VS Code

Creá .vscode/mcp.json con el mismo bloque mcpServers de arriba.

El servidor lee las credenciales del archivo .env del proyecto, así que no hace falta declarar variables de entorno en la configuración de ningún cliente. Si preferís pasarlas por entorno igual, tienen prioridad las que ya estén definidas en el sistema.

Herramientas disponibles

Herramienta	Qué hace	Parámetros
listar_materias	Tus materias con ID y porcentaje de avance	—
ver_contenido_materia	Índice de unidades; con unidad, el detalle y las URLs de los archivos	courseid, unidad?
proximos_vencimientos	Entregas y cierres de cuestionarios de todas las materias, ordenados por fecha	dias? (30)
ver_trabajos_practicos	TPs con consigna, fecha de entrega y si ya entregaste	courseid, solo_pendientes?
ver_notas	Calificaciones, estado y devoluciones del profesor	courseid, solo_calificados?
leer_avisos_foro	Publicaciones de los foros de avisos	courseid, todos_los_foros?, limite?
descargar_archivo	Baja un archivo del campus a descargas/, o a la carpeta que le indiques	url, nombre?, destino?

El flujo típico es empezar por listar_materias para obtener el ID de una materia, y usar ese ID en las demás.

Dos detalles de diseño, por si los tocás:

• ver_contenido_materia devuelve un índice por defecto. Las materias tienen decenas de unidades y traer todo junto llena el contexto sin necesidad. Primero el índice, después el detalle de la unidad que interese.
• proximos_vencimientos no usa el calendario de Moodle. Lo arma leyendo las fechas reales de las entregas y los cuestionarios, porque el calendario omite actividades ya completadas y devolvía listas vacías.

Compatibilidad con otros modelos

MCP es un protocolo abierto y agnóstico del modelo. Este servidor no contiene código específico de ningún proveedor: expone herramientas por JSON-RPC, y cada cliente las traduce al mecanismo de function calling de su modelo. Funciona igual con Claude, GPT, Gemini o cualquier modelo con soporte de herramientas.

Problemas comunes

invalidtoken — El token venció o se copió incompleto. Volvé a generarlo con el curl del paso 2.

invalidlogin al pedir el token — Usuario o contraseña incorrectos. Probá entrar al campus por el navegador para confirmar tus credenciales.

El cliente no ve el servidor — Verificá que la ruta en la configuración sea absoluta y apunte a src/index.js. Probá primero npm run probar-token.

Una herramienta devuelve una lista vacía — Es normal si la materia no tiene ese tipo de contenido (por ejemplo, ver_trabajos_practicos en una materia sin TPs cargados).

Usarlo con otro campus Moodle

No hay nada atado a la UTN en el código: cambiá MOODLE_URL en tu .env por la URL de cualquier otro Moodle que tenga los web services habilitados.

Para verificar si un campus los tiene activos:

curl -s "https://EL-CAMPUS/login/token.php?username=x&password=x&service=moodle_mobile_app"

Si responde invalidlogin, están habilitados (solo faltan credenciales válidas). Si responde que el servicio no está disponible, el administrador tiene que activarlos.

Desarrollo

npm run typecheck   # chequeo de tipos vía JSDoc, sin compilar
npm start           # levanta el servidor a mano (habla MCP por stdin/stdout)

El proyecto es JavaScript con anotaciones JSDoc y checkJs activado: tenés autocompletado y verificación de tipos en el editor sin ningún paso de compilación.

Licencia

MIT