UCA MCP Server

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

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:

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