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 分