Uca Mcp

io.github.santinohickePublished by GitHub account santinohickev1.1.0Updated Nov 1, 2026

MCP no oficial para estudiantes de la UCA: EVA y SIU Guaraní (materias, notas, horarios, exámenes).

Overview

AI-generated overview

Unofficial MCP server that connects an AI assistant to Universidad Católica Argentina student platforms (EVA, SIU Guaraní, Campus) for courses, grades…

What you can do
  • List enrolled virtual classrooms, course sections, resources and search or download course materials to the local machine
  • Read assignments, deadlines, submission status, grades, quizzes and forum threads, and extract text from PDF and Office files
  • Check weekly class schedules, attendance, academic record, averages, degree progress and which courses are unlocked by prerequisites
  • Look up exam dates, exam boards, pending teacher surveys, certificate history and tuition or administrative status
  • Draft assignment submissions, post forum replies, enroll in final exams and issue regular-student certificates after user confirmation
  • Run a combined weekly summary of upcoming deadlines, notices and…
When to use it
Meant for UCA students who want an assistant to answer questions about their own coursework: what is due next week, when a midterm or retake is scheduled, what classes they have today, how many courses remain to graduate, or which courses to enroll in next term.
Requirements
Runs locally over stdio as an npm package (uca-mcp) and needs Node.js 20.18.1 or newer, or the .mcpb bundle for Claude Desktop. A one-time browser login with an @uca.edu.ar account and 2FA is required; credentials are stored in the operating system keychain. Network access to the university platforms is needed. No remote HTTP transport, so web and mobile clients are not supported.
Before you install
Unofficial and not endorsed by the university. It stores encrypted session cookies and credentials locally, and any process running under the same user account with shell access could read them. Several tools write to institutional systems: assignment drafts, forum replies, exam enrollment and certificate issuance, each behind a confirmation prompt. Reading resources or folders is logged as a view on the platform, and exam withdrawal is not available. Forum and document content is treated as…

Installation

In SourceWeft

  1. Open Uca Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

UCA MCP — Servidor Model Context Protocol para la Universidad Católica Argentina (UCA)

[Node.js] [Licencia] [MCP] [Sitio web]

Sitio web: ucamcp.com — guía de instalación, preguntas frecuentes y documentación en lenguaje simple.

Servidor Model Context Protocol (MCP) open source para conectar a tus asistentes de IA (Claude Desktop, Cursor, VS Code, Gemini, etc.) de forma segura y directa con las plataformas institucionales de la Universidad Católica Argentina:

  • EVA (eva.uca.edu.ar)
  • SIU Guaraní (guarani.uca.edu.ar)
  • Campus Autogestión (autogestion.uca.edu.ar)

Privacidad y Tratamiento de Datos:

  • El software opera 100% de manera local en tu computadora.
  • Las credenciales se cifran localmente en tu computadora y se resguardan en el Llavero nativo del Sistema Operativo (Windows DPAPI, macOS Keychain, Linux Secret Service).
  • Todas las subidas (entrega de tareas, respuestas a foros o inscripciones) están protegidas por una confirmación explícita del usuario (ventana de confirmación del cliente, o un diálogo del sistema si el cliente no la ofrece).

Instalación

Prerequisito: Necesitás Node.js v20.18.1 o superior instalado en tu computadora (salvo la opción .mcpb de Claude Desktop que no lo requiere).

Elegí tu cliente y seguí los pasos. El uca-mcp login abre el navegador para que te loguees con tu cuenta @uca.edu.ar y el 2FA — hacelo una sola vez.


Claude Desktop

Opción A — Sin terminal (recomendada):

  1. Descargá uca-mcp-1.1.0.mcpb desde Releases.
  2. En Claude Desktop andá a Configuración → Extensiones y arrastrá el archivo .mcpb.
  3. Abrí un nuevo chat y escribí "Iniciá sesión en UCA". Listo.

Opción B — Desde terminal:

bash
npm install -g uca-mcpuca-mcp loginuca-mcp setup claude

Reiniciá Claude Desktop y ya está conectado.


Claude Code / Claude Code CLI

bash
npm install -g uca-mcpuca-mcp loginclaude mcp add uca -- uca-mcp serve

Antigravity / Antigravity CLI

bash
npm install -g uca-mcpuca-mcp loginagy mcp add uca -- uca-mcp serve

ChatGPT Desktop / Codex CLI

bash
npm install -g uca-mcpuca-mcp logincodex mcp add uca -- uca-mcp serve

Cursor

bash
npm install -g uca-mcpuca-mcp loginuca-mcp setup cursor

Reiniciá Cursor y ya está conectado.


VS Code

bash
npm install -g uca-mcpuca-mcp loginuca-mcp setup vscode

Reiniciá VS Code y ya está conectado.


Hermes

bash
npm install -g uca-mcpuca-mcp loginhermes mcp add uca -- uca-mcp serve

OpenClaw

bash
npm install -g uca-mcpuca-mcp loginopenclaw mcp add uca --command "uca-mcp" --arg "serve"

OpenCode

bash
npm install -g uca-mcpuca-mcp loginopencode mcp add uca -- uca-mcp serve

Pi

bash
npm install -g uca-mcpuca-mcp loginpi mcp add uca -- uca-mcp serve

Configuración manual (JSON) para cualquier cliente

Si tu cliente no está listado, agregá el servidor a su archivo de configuración MCP (mcpServers). Con la instalación global:

json
{  "mcpServers": {    "uca": { "command": "uca-mcp", "args": ["serve"] }  }}

Verificar que todo funcione (opcional)

Desde cualquier terminal, después de instalar y loguearte:

bash
uca-mcp doctor

Comprueba Node.js, llavero del sistema, navegador, diálogo nativo y conectividad a EVA, SIU Guaraní y Campus.

[!NOTE] Transporte Exclusivo STDIO Local: En esta versión (v1), no cuenta con transporte HTTP/SSE remoto, por lo que no es compatible directamente con ChatGPT Web ni aplicaciones móviles sin un túnel MCP local autogestionado.


Catálogo de Herramientas MCP

HerramientaPlataformaTipoDescripción
uca_diagnosticar_sistemaLocalAuth/DiagAudita conectividad, validez del entorno gráfico y estado de la sesión cifrada.
uca_iniciar_sesionEntra IDAuthAbre el navegador de forma no bloqueante para completar o renovar el login con 2FA.
uca_resumen_semanalCompuestaLecturaConsulta en paralelo entregas próximas de EVA, avisos de foros y cursadas de Guaraní.
eva_materiasEVALecturaLista las aulas virtuales matriculadas y sus identificadores (curso_id).
eva_contenido_cursoEVALecturaLista las secciones, temas, recursos y tareas de un curso.
eva_cronogramaEVALecturaBusca el cronograma o programa de la materia y extrae fechas de parciales, recuperatorios y entregas.
eva_entregas_proximasEVALecturaConsulta qué entregas vencen en los próximos días (ej. la semana que viene) y avisos de cátedra.
eva_cuestionariosEVALecturaConsulta cuestionarios, fechas de cierre, intentos y calificaciones en EVA.
eva_tareas_y_notasEVALecturaConsulta tareas pendientes, fechas límite y estado de calificaciones.
eva_forosEVALecturaObtiene avisos de cátedra y discusiones recientes (con aviso de contenido no confiable).
eva_hilo_foroEVALecturaObtiene el debate o hilo completo de un foro de cátedra con todas sus respuestas y mensajes.
eva_buscar_materialesEVALecturaBusca recursos y consignas por palabra clave en todas tus aulas.
eva_descargar_materialesEVALectura (guarda en tu PC)Baja a una carpeta de tu computadora los parciales, apuntes y archivos de una materia (también los que están dentro de carpetas).
eva_leer_archivoEVALecturaDescarga y extrae texto de PDFs y Office (.docx/.xlsx/.pptx) con allowlist estricta HTTPS y anti zip-bombs.
eva_guardar_borrador_tareaEVAMutaciónSube un borrador editable de entrega tras validación y tu confirmación.
eva_responder_foroEVAMutaciónPublica una respuesta en un foro mostrando el texto completo tras tu confirmación.
guarani_progreso_carreraSIU GuaraníLecturaResponde exactamente cuántas materias te faltan para recibirte, cuáles estás cursando y el avance por año.
guarani_plan_optimoSIU GuaraníLecturaCalcula el plan óptimo de cursada rankeando materias por cierre transitivo de correlativas y camino crítico.
guarani_materias_habilitadasSIU GuaraníLecturaComputa qué materias pendientes podés cursar el próximo período según tu grafo de correlativas.
guarani_estado_cursadaSIU GuaraníLecturaHorarios, asistencias acumuladas, porcentaje de faltas y predictor de regularidad de cursadas activas.
guarani_horario_semanalSIU GuaraníLecturaHorario semanal estructurado con materias, días, horarios, aulas y comisiones (admite filtro 'hoy').
guarani_cronograma_evaluacionesSIU GuaraníLecturaFechas oficiales de parciales, recuperatorios y otras evaluaciones de tus cursadas actuales.
guarani_historia_academicaSIU GuaraníLecturaAnalítico completo: finales aprobados, materias regulares, libro, folio y promedios.
guarani_mesas_disponiblesSIU GuaraníLecturaMesas de examen final con fechas, turnos, tribunales y estado de inscripción.
guarani_mis_inscripciones_examenSIU GuaraníLecturaConsulta inscripciones vigentes a examen final y actuaciones provisorias.
guarani_encuestas_pendientesSIU GuaraníLecturaVerifica si hay encuestas docentes institucionales obligatorias o pendientes de responder.
guarani_historial_constanciasSIU GuaraníLecturaConsulta el historial de solicitudes de constancias y certificados emitidos con descarga de PDF.
guarani_correlatividades_y_planSIU GuaraníLecturaPlan interactivo, materias por año, correlativas para cursar/rendir e impacto a futuro.
guarani_certificado_alumno_regularSIU GuaraníMutaciónEmite y descarga formalmente en PDF la Constancia de Alumno Regular (o aprobadas/promedio) con código de validación institucional tras tu confirmación.
guarani_inscribir_examenSIU GuaraníMutaciónCiclo atómico en 2 fases con tu confirmación. Nota: La baja de examen no está disponible vía MCP (v1) y debe realizarse en SIU Guaraní.
campus_aranceles_y_tramitesCampusLecturaConsulta de cuotas al día/pendientes y estado de trámites administrativos (estricto read-only).

Seguridad y Arquitectura

  1. Blindaje de STDOUT (src/silence-stdout.ts): Todo log, advertencia o salida de procesos secundarios se redirige a stderr. El transporte JSON-RPC corre exclusivamente sobre mcpStdoutStream, garantizando que la trama no se corrompa jamás.
  2. Confirmación independiente del LLM: Las acciones de mutación no pueden ser auto-aprobadas por el LLM ni por inyecciones de prompt. Primero se usa el formulario de confirmación del propio cliente (MCP Elicitation, Canal A), que es el más cómodo. Si el cliente no lo soporta, se despliega una ventana modal nativa del sistema operativo (Canal B: WScript.Shell.Popup en Windows, osascript en macOS, zenity / kdialog / yad en Linux) con botón Cancelar por defecto y timeout de 45 segundos (fail-closed).
  3. Llavero Nativo y Cero Secretos en argv: Las claves maestras se manejan mediante canal stdin (en Windows DPAPI, macOS Keychain mediante security -i, y Linux Secret Service vía secret-tool con soporte de UCA_PASSPHRASE y fallback degradado a machine-id), evitando que secretos aparezcan en ps o en variables de entorno. Asimismo, las cookies de sesión de Entra ID se alojan en el perfil persistente de navegador (browser-profile/), protegidas bajo el cifrado nativo de Chromium en el sistema operativo (DPAPI en Windows). En macOS y Linux, el aislamiento recae en los permisos de archivo locales del usuario del sistema operativo. El comando uca-mcp logout (o invocar uca_iniciar_sesion con forzar_relogin: true) purga este directorio y los certificados descargados por completo.
  4. Protección Anti-SSRF y Anti Zip-Bomb:
    • Descargas restringidas exclusivamente a https://eva.uca.edu.ar bajo /pluginfile.php o /mod/.
    • Streaming de descarga con límite rígido de 25 MB.
    • Descompresión en streaming con BoundedUnzipInflate de fflate para abortar inmediatamente durante la descompresión si los bytes reales superan los 60 MB, neutralizando cabeceras falsificadas.
  5. Modelo de Amenazas y Límites de Seguridad del Sistema Operativo:
    • La confirmación del usuario previene inyecciones de prompt indirectas, escalamiento de contexto o ejecución autónoma no autorizada de herramientas por parte del LLM.
    • Límites de aislamiento del host: Si un agente de IA o proceso secundario posee permisos de shell o ejecución arbitraria de comandos en el sistema operativo bajo la misma cuenta de usuario (mismo UID/SID), dicho proceso tiene acceso nativo al sistema de archivos local y podría leer las cookies de sesión, el llavero o los perfiles de navegador. Se recomienda ejecutar agentes con acceso a shell en entornos aislados o contenedores.

Esta herramienta fue creada para estudiantes de la UCA y no cuenta con patrocinio, aval, asociación ni relación formal con la Universidad Católica Argentina.

Licencia

Este proyecto se distribuye bajo los términos de la Licencia MIT. Consultá el archivo LICENSE para más detalles.

Source: README.md at commit 6b04c46

Tools

31

uca_diagnosticar_sistema

Diagnóstico del Sistema UCA

Audita conectividad, estado de sesión cifrada, validez del entorno gráfico y rutas de almacenamiento.

Takes no parameters.

uca_iniciar_sesion

Iniciar Sesión Institucional UCA

Inicia o renueva la sesión institucional abriendo el navegador. Si ya hay una sesión activa responde SESION_ACTIVA (ya está iniciada) sin abrir el navegador. NO hace falta llamarla antes de consultar: cada herramienta renueva la sesión sola. Usar solo si una consulta devolvió error de sesión expirada o si el usuario pide iniciar sesión o cambiar de cuenta.

Parametersforzar_relogin

eva_materias

Materias y Cursos en EVA

Lista las aulas virtuales y materias matriculadas en EVA con sus identificadores de curso. Por defecto lista cursos activos; con incluir_archivadas: true lista también los cursos pasados u ocultos.

Parametersforzar_refrescoincluir_archivadas

eva_contenido_curso

Contenido del Curso en EVA

Lista las secciones, módulos, tareas y recursos pertenecientes a un curso en EVA. Permite filtrar por tipo o sección para presupuestar contexto.

Parameterscurso_idrequiredseccion_idfiltro_tipoforzar_refresco

eva_tareas_y_notas

Tareas y Notas en EVA

Obtiene tareas, plazos de entrega, estado de entregas y fechas límite en EVA.

Parameterscurso_idincluir_cerradas

eva_foros

Foros y Avisos en EVA

Obtiene los últimos avisos institucionales y mensajes de foros de cátedra (etiquetados con aviso de seguridad).

Parameterslimitcurso_idforzar_refresco

eva_hilo_foro

Hilo Completo de Foro en EVA

Obtiene el debate o hilo completo de un foro de cátedra en EVA, incluyendo todas las respuestas y mensajes ordenados.

Parametersdiscusion_idrequired

eva_buscar_materiales

Buscar Materiales en EVA

Busca recursos, consignas y documentos en EVA por palabra clave.

Parametersqueryrequiredlimitecurso_id

eva_descargar_materiales

Descargar Materiales de EVA a una Carpeta

Descarga archivos de EVA (parciales, apuntes, guías, incluso los que están dentro de carpetas) a una carpeta de tu computadora. Ej: todos los parciales de una materia. Usá 'curso_id' (de eva_materias) y 'query' para filtrar por nombre. Guarda en Descargas/UCA si no indicás 'carpeta_destino'. No modifica nada en EVA.

Parametersqueryseccioncurso_idmax_archivoscarpeta_destinoforzar_refresco

eva_leer_archivo

Lectura de Archivos en EVA

Descarga de forma segura (con allowlist HTTPS) y extrae texto de PDFs y Office, o retorna bloques de imagen en escaneados. Nota: La consulta de recursos o carpetas en EVA registra la visualización en la plataforma.

Parametersurlcmidmax_paginasdesde_paginaforzar_refresco

eva_cuestionarios

Cuestionarios y Exámenes Parciales en EVA

Consulta cuestionarios, exámenes parciales online, fechas de apertura/cierre, intentos y calificaciones en EVA (Lectura pura).

Parameterscurso_idforzar_refresco

eva_cronograma

Cronograma, Programa y Fechas de Parciales en EVA

Busca el archivo de cronograma o programa de una materia en EVA y extrae las fechas de parciales, recuperatorios y entregas. Elige el programa/cronograma por nombre; si no hay uno claro devuelve candidatos para elegir. Incluye fechasDetectadas y avisoFechas (avisa si el documento no publica fechas concretas). Si no existe cronograma ni programa en el aula virtual, informa explícitamente que no hay.

Parametersmateriarequired

eva_entregas_proximas

Entregas Próximas y Avisos de la Semana en EVA

Consulta qué tareas, trabajos prácticos o actividades tienen fecha de vencimiento en los próximos días (por defecto 7 días / la semana que viene) y avisos recientes de cátedra.

Parametersdiascurso_id

uca_resumen_semanal

Resumen Semanal del Alumno

Tool Compuesta: Trae en paralelo tareas próximas de EVA, avisos de cátedra, cursada/inasistencias, clases de hoy e inscripciones a finales de Guaraní.

Parameterscarrera

guarani_estado_cursada

Estado de Cursadas en Guaraní

Detalla cursadas activas, horarios, regularidad e inasistencias acumuladas en SIU Guaraní.

Parameterscarrera

guarani_horario_semanal

Horario Semanal de Clases en Guaraní

Consulta el horario semanal de clases estructurado con día, horario de inicio y fin, aula y comisión desde SIU Guaraní. Soporta filtro para el día de hoy ('¿qué tengo hoy?').

Parametersdiacarreraforzar_refresco

guarani_cronograma_evaluaciones

Cronograma de Evaluaciones en Guaraní

Fechas oficiales de parciales, recuperatorios y otras evaluaciones de tus cursadas actuales (SIU Guaraní), con hora y comisión. Por defecto solo las próximas. IMPORTANTE: no siempre incluye todas las materias; el campo materiasSinFechasCargadas lista las materias en curso sin fechas en Guaraní, para las cuales hay que usar eva_cronograma, eva_entregas_proximas y eva_cuestionarios.

Parameterscarreraforzar_refrescoincluir_pasadas

guarani_historia_academica

Historia Académica y Analítico en Guaraní

Analítico completo: finales aprobados, materias pendientes, notas y promedios en SIU Guaraní.

Parameterscarrera

guarani_mesas_disponibles

[EXPERIMENTAL] Mesas de Examen en Guaraní

[EXPERIMENTAL] Mesas de examen final con fechas, turnos, tribunales y condición en SIU Guaraní. Parser experimental hasta contar con fixtures HTML anonimizados de turnos activos.

Parameterscarrerarequiredmateriarequiredforzar_refresco

guarani_correlatividades_y_plan

Plan de Estudios, Correlatividades e Impacto en Guaraní

Consulta el plan de estudios interactivo, materias por año, estado de aprobación y correlatividades para cursar y rendir final. Si se especifica una materia, analiza qué correlativas la traban y qué materias futuras dependen de ella.

Parameterscarreramateria

guarani_materias_habilitadas

Materias Habilitadas para Cursar en Guaraní

Calcula qué materias del plan de estudio el alumno está en condiciones de cursar el próximo período según su grafo de correlatividades y materias ya regularizadas o aprobadas.

Parameterscarrera

guarani_progreso_carrera

Progreso de Carrera y Materias Faltantes para Recibirse

Calcula exactamente cuántas materias te faltan para recibirte en SIU Guaraní ('Te faltan X materias'), cuántas tenés aprobadas, cursando actualmente y el desglose de materias pendientes por año.

Parameterscarrera

guarani_plan_optimo

Plan Óptimo de Cursada y Desbloqueo de Correlatividades

Rankea las materias habilitadas para cursar según su impacto multiplicador en el grafo de correlatividades (cierre transitivo de materias desbloqueadas) y calcula la altura del camino crítico y la estimación de cuatrimestres mínimos para recibirse.

Parameterscarreramax_sugerencias

guarani_mis_inscripciones_examen

Mis Inscripciones a Examen Final en Guaraní

Consulta las inscripciones activas a mesas de examen final y actuaciones provisorias del alumno en SIU Guaraní.

Parameterscarreraforzar_refresco

guarani_encuestas_pendientes

Encuestas Docentes Pendientes en Guaraní

Consulta si el alumno tiene encuestas docentes institucionales obligatorias o pendientes de responder en SIU Guaraní.

Parameterscarrera

guarani_historial_constancias

Historial de Solicitudes de Constancias en Guaraní

Consulta el historial de solicitudes de constancias y certificados emitidos en SIU Guaraní, con opción de descarga de PDFs.

Parameterscarreradescargar

campus_aranceles_y_tramites

[EXPERIMENTAL] Aranceles y Trámites en Campus

[EXPERIMENTAL] Consulta aranceles al día/pendientes y estado de trámites administrativos en Campus Autogestión. Incluye saldo, habilitación para cursar/rendir y trámites en curso.

Parametersconsulta

eva_guardar_borrador_tarea

[EXPERIMENTAL] Guardar Borrador de Tarea en EVA

[EXPERIMENTAL] Sube un archivo o texto a EVA en modo borrador editable. Requiere confirmación del usuario.

Parameterscmidrequiredruta_archivotexto_en_linea

eva_responder_foro

Responder en Foro de Cátedra en EVA

Publica una respuesta en un foro de cátedra de EVA. Muestra el texto completo y requiere confirmación del usuario.

Parametersmensajerequireddiscusion_idrequired

guarani_inscribir_examen

Inscripción a Examen Final en Guaraní

Inscribe a examen final en SIU Guaraní mediante ciclo en dos fases y confirmación del usuario.

Parameterscarrerarequiredmateriarequiredllamado_idrequired

guarani_certificado_alumno_regular

Solicitud y Descarga de Constancia de Alumno Regular en Guaraní

Emite y descarga formalmente en PDF la Constancia de Alumno Regular (o de actividades aprobadas/promedio) con código de validación institucional desde SIU Guaraní. Protegida por confirmación del usuario.

Parameterscopiascarrerapresentar_aforzar_nuevaobservacionestipo_constancia

Version history

3
  1. v1.1.0LatestNov 1, 2026
  2. v1.0.10Nov 1, 2026
  3. v1.0.8Oct 31, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts