io.github.santinohicke/uca-mcp

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

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 (Canal B / Elicitation).

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.0.8.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:

npm install -g uca-mcp
uca-mcp login
uca-mcp setup claude

Reiniciá Claude Desktop y ya está conectado.

Claude Code / Claude Code CLI

npm install -g uca-mcp
uca-mcp login
claude mcp add uca -- uca-mcp serve

Antigravity / Antigravity CLI

npm install -g uca-mcp
uca-mcp login
agy mcp add uca -- uca-mcp serve

ChatGPT Desktop / Codex CLI

npm install -g uca-mcp
uca-mcp login
codex mcp add uca -- uca-mcp serve

Cursor

npm install -g uca-mcp
uca-mcp login
uca-mcp setup cursor

Reiniciá Cursor y ya está conectado.

VS Code

npm install -g uca-mcp
uca-mcp login
uca-mcp setup vscode

Reiniciá VS Code y ya está conectado.

Hermes

npm install -g uca-mcp
uca-mcp login
hermes mcp add uca -- uca-mcp serve

OpenClaw

npm install -g uca-mcp
uca-mcp login
openclaw mcp add uca --command "uca-mcp" --arg "serve"

OpenCode

npm install -g uca-mcp
uca-mcp login
opencode mcp add uca -- uca-mcp serve

Pi

npm install -g uca-mcp
uca-mcp login
pi 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:

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

Verificar que todo funcione (opcional)

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

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

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. Canal B Independiente y Elicitation: Las acciones de mutación no pueden ser auto-aprobadas por el LLM ni por inyecciones de prompt. Se despliega una ventana modal nativa del sistema operativo (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). En entornos headless o donde las ventanas nativas no estén disponibles, conmuta de forma transparente a Canal A (formulario interactivo MCP Elicitation) sin falsos rechazos de usuario.
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:
   • Canal B y Elicitation previenen 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.