Uca Mcp

io.github.santinohicke由 GitHub 账号 santinohicke 发布v1.1.0更新于 Nov 1, 2026

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

概览

AI 生成的概览

非官方 MCP 服务器,让 AI 助手连接阿根廷天主教大学(UCA)的学生平台 EVA、SIU Guaraní 与 Campus,查询课程、成绩、课表和考试。

可以做什么
  • 列出已注册的虚拟课堂、课程章节与资源,按关键词搜索课程材料并下载到本机
  • 读取作业、截止日期、提交状态、成绩、测验与论坛帖子,并提取 PDF 和 Office 文件文本
  • 查询每周课表、出勤、成绩单、平均分、毕业进度以及先修课解锁的课程
  • 查看考试日期与考场安排、待填教师问卷、证明申请记录以及学费和行政手续状态
  • 在用户确认后保存作业草稿、回复论坛、报名期末考试并开具在读证明
  • 生成汇总近期截止事项、通知与报名的每周摘要,并做本地连接与会话诊断
适用场景
适合 UCA 学生让助手回答与本人学业相关的问题:下周要交什么、某门课的期中或补考何时进行、今天上什么课、还差多少门课毕业,或下学期该选哪些课。
运行要求
以 npm 包 uca-mcp 形式在本地通过 stdio 运行,需要 Node.js 20.18.1 或更高版本,Claude Desktop 也可使用 .mcpb 安装包。需用 @uca.edu.ar 账号和两步验证在浏览器中完成一次性登录,凭据保存在操作系统钥匙串中。需要能访问学校各平台的网络。不提供远程 HTTP 传输,因此不支持网页版和移动端客户端。
安装前请注意
非官方工具,未获学校认可或背书。它在本机保存加密的会话 Cookie 和凭据,同一用户账号下拥有 shell 权限的其他进程可能读取。多个工具会写入学校系统:作业草稿、论坛回复、考试报名和证明开具,均需用户确认。查看资源或文件夹会在平台上记录为一次浏览,且不支持退选考试。论坛和文档内容按不可信文本处理。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Uca Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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.

来源:README.md,提交 6b04c46

工具

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.

无需输入参数。

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.

输入参数forzar_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.

输入参数forzar_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.

输入参数curso_id必填seccion_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.

输入参数curso_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).

输入参数limitcurso_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.

输入参数discusion_id必填

eva_buscar_materiales

Buscar Materiales en EVA

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

输入参数query必填limitecurso_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.

输入参数queryseccioncurso_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.

输入参数urlcmidmax_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).

输入参数curso_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.

输入参数materia必填

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.

输入参数diascurso_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í.

输入参数carrera

guarani_estado_cursada

Estado de Cursadas en Guaraní

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

输入参数carrera

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?').

输入参数diacarreraforzar_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.

输入参数carreraforzar_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í.

输入参数carrera

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.

输入参数carrera必填materia必填forzar_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.

输入参数carreramateria

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.

输入参数carrera

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.

输入参数carrera

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.

输入参数carreramax_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í.

输入参数carreraforzar_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í.

输入参数carrera

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.

输入参数carreradescargar

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.

输入参数consulta

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.

输入参数cmid必填ruta_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.

输入参数mensaje必填discusion_id必填

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.

输入参数carrera必填materia必填llamado_id必填

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.

输入参数copiascarrerapresentar_aforzar_nuevaobservacionestipo_constancia

版本历史

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

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分