UniMCP

UniMCP: el puente entre tu agente y los sistemas de tu universidad

Este es un Model Context Protocol server NO OFICIAL para universidades argentinas. Con él podés pedirle a tu agente (Claude, ChatGPT, etc.) que lea los apuntes del aula virtual (Moodle) y consulte tu SIU Guaraní y, con tu confirmación, que publique en los foros o entregue tareas. Corre en tu computadora o como servidor HTTP con OAuth.

¿Sos alumno y no programás? Empezá por la guía para alumnos.

Qué podés pedirle

• "¿Cuándo es el recuperatorio del primer parcial de Álgebra?"
• "¿Qué avisó la profesora de Física esta semana?"
• "Resumime la guía de la unidad 3 de Sistemas Operativos."
• "¿Qué tengo que entregar esta semana?"
• "¿Cómo voy en Física?"
• "¿Hay algo nuevo en el aula esta semana?"
• "¿Me contestó el profe de Álgebra?"
• "¿Qué nota me pusieron en el TP1 y qué me corrigieron?"
• "¿Qué finales tengo aprobados y cuál es mi promedio?" (Guaraní)
• "¿En qué materias estoy inscripto este cuatrimestre?" (Guaraní)
• "¿Qué mesas de examen hay para Análisis II?" (Guaraní)

Universidades y campus

Cada aula se verificó con tool_mobile_get_public_config (el servicio móvil de Moodle tiene que estar habilitado) y cada Guaraní con su página de login de autogestión. Entran las aulas con login propio de Moodle o con SSO de Keycloak: las que entran con SAML, OAuth2 o un portal propio (como varias de la UNC) todavía no. Probado a fondo solo en UNJu; los demás faltan probarlos con usuarios reales. Si sos de otra universidad, probalo y contanos cómo te fue con la plantilla Probé mi universidad, aunque haya andado todo bien. Si tu facultad usa Moodle y no está, pedila con Pedir mi universidad. Más formas de colaborar en CONTRIBUTING.md.

Sumar tu campus

Si el tuyo no está, podés usarlo igual con variables de entorno (o un .env, ver .env.example):

UNI_AULA_BASE_URL=https://virtual.tu-universidad.edu.ar
UNI_GUARANI_URL=https://autogestion.tu-universidad.edu.ar/autogestion
# UNI_SSO_HOST=sso.tu-universidad.edu.ar   # solo si el aula entra por Keycloak

y en el login elegís personalizado. Para sumarlo para todos, agregá una entrada en CAMPUSES de src/shared/campus.ts. Para saber si un Moodle sirve:

curl -s -X POST "https://TU-AULA/lib/ajax/service-nologin.php?info=tool_mobile_get_public_config" \
  -H 'content-type: application/json' -d '[{"index":0,"methodname":"tool_mobile_get_public_config","args":{}}]'

Tiene que contestar "enablemobilewebservice":1. Si trae identityproviders, el login pasa por un SSO y hay que cargar su host en ssoHost.

Tools

Aula virtual (Moodle)

También trae un prompt, aula_plan_semana (en Claude Desktop, en el menú "+"): arma el plan de la semana con lo que tenés que entregar, lo nuevo en el aula y cómo vas en cada materia.

SIU Guaraní (autogestión, G3W)

Guaraní no tiene API: el servidor entra con tu usuario y lee las páginas como lo harías vos. Por ahora solo lee: para inscribirte, el agente te pasa el link. Las tools solo aparecen si tu campus tiene esa plataforma.

Cómo instalar

Instalación fácil: Claude Desktop

1. Bajá unimcp-<versión>.mcpb del último release.
2. Hacele doble click (o arrastralo a Configuración → Extensiones de Claude Desktop) e instalalo.
3. Completá tu campus (el id de la tabla de arriba, por ejemplo unju) y tus usuarios y contraseñas del aula y de Guaraní. Claude Desktop guarda las contraseñas de forma segura y solo viajan a tu universidad.

No hace falta instalar nada más: Claude Desktop trae su propio Node.

Con la terminal (cualquier cliente)

Necesitás Node.js 22 o superior.

1. Iniciar sesión

npx -y @nuwujix/unimcp login

Buscás tu campus por sigla, facultad o provincia (UNC, exactas, Córdoba), y te pide el usuario y la contraseña del aula y después los de Guaraní (que suele ser tu DNI). Si te equivocás de contraseña, te la vuelve a pedir (hasta 3 veces, para que no se bloquee tu cuenta). Se hace una sola vez: después el servidor renueva las sesiones solo.

Para ver si anda todo, npx -y @nuwujix/unimcp check prueba los logins y dice qué tools funcionan en tu aula, sin mostrar datos personales. Si anduvo, pegá el resumen en el hilo del mapa y aparecés en la web, en el pin de tu campus.

2. Agregarlo a tu cliente

Claude Code

claude mcp add uni -- npx -y @nuwujix/unimcp

Claude Desktop: en Settings → Developer → Edit Config, dentro de mcpServers:

"uni": {
  "command": "npx",
  "args": ["-y", "@nuwujix/unimcp"]
}

En Windows, si no arranca, usá "command": "cmd" y "args": ["/c", "npx", "-y", "@nuwujix/unimcp"].

Codex: codex mcp add uni -- npx -y @nuwujix/unimcp · Gemini CLI: gemini mcp add uni npx -y @nuwujix/unimcp

Cursor (~/.cursor/mcp.json) y VS Code (.vscode/mcp.json): un servidor STDIO con "command": "npx" y "args": ["-y", "@nuwujix/unimcp"].

Cualquier cliente MCP que lance servidores por STDIO sirve con npx -y @nuwujix/unimcp.

Modo HTTP (opcional)

Necesita Node 22.13 o más nuevo:

npx -y @nuwujix/unimcp login --http   # una vez: te muestra el token para el header Authorization
npx -y @nuwujix/unimcp --http --port 3000

Hosteado, el servidor también hace de servidor de autorización OAuth: el cliente MCP abre una página donde el alumno elige su campus y entra con su usuario del aula. La contraseña se usa una sola vez y no se guarda. La configuración (quién puede entrar, URL pública, clave de cifrado) está en .env.example, con las variables UNIMCP_*.

En modo HTTP, por defecto no hay tools que escriben (publicar, mandar mensajes, entregar): así, un post que intente darle órdenes al modelo no puede hacer que publique en nombre del alumno. Quien hostea las habilita con UNIMCP_WRITE_TOOLS (all o una lista de nombres), y si faltan, el servidor se lo avisa al agente para que te diga que lo hagas desde el aula. Instalado en tu compu están todas, y UNIMCP_WRITE_TOOLS=none las saca.

En modo HTTP SIU Guaraní todavía no está disponible: su sesión vence en minutos y renovarla necesita la contraseña, que el servidor hosteado no guarda.

Con Docker:

docker build -t unimcp .
docker run -d --name unimcp --network host --restart unless-stopped \
  -e HOST=127.0.0.1 -e PORT=8100 -e UNIMCP_PUBLIC_URL=https://mcp.tu-dominio.com \
  -e UNIMCP_KEY=$(openssl rand -base64 32) -v unimcp-data:/data unimcp

Dónde se guardan tus datos

Instalado en tu computadora, todo queda ahí:

• Usuarios y contraseñas (aula y Guaraní): en el gestor de credenciales del sistema (Windows Credential Manager, Keychain en macOS, Secret Service en Linux). Sin gestor, por variables de entorno: UNI_USER/UNI_PASS y UNI_GUARANI_USER/UNI_GUARANI_PASS.
• Campus elegido, token del aula y cookies de sesión: en %APPDATA%\unimcp\ (Windows) o ~/.config/unimcp/ (Linux y macOS).
• Con la extensión de Claude Desktop: las contraseñas las guarda Claude Desktop (en los campos marcados como sensibles de la extensión), y el token y las cookies van a la misma carpeta.
• En modo HTTP: la contraseña no se guarda; la sesión va cifrada en unimcp.db, con la clave de store.key (o la de UNIMCP_KEY). Del token del cliente solo se guarda el hash.

Los links que el agente te pasa abren con la sesión de tu navegador y nunca incluyen tu token.

Los datos de otras personas que aparecen en el aula (una lista de alumnos con DNI o legajo, el teléfono o el mail de un compañero) no le llegan al agente: las listas se resumen en si figurás o no, y los DNI, emails y teléfonos sueltos se tapan. Quedan los tuyos y los mails institucionales o de contacto de la cátedra. En tu compu podés verlos enteros con UNI_SHOW_THIRD_PARTY_DATA=1.

Si encontrás una falla de seguridad, reportala en privado como explica SECURITY.md.

Desarrollo

npm install
npm run login   # una vez
npm run dev     # servidor por STDIO desde src/, con tsx
npm test        # tests, con respuestas inventadas de Moodle y G3W
npm run build   # compila a build/
npm run mcpb    # arma la extensión de Claude Desktop (unimcp-<versión>.mcpb)

La arquitectura y las convenciones están en AGENTS.md, y lo que sigue en el roadmap.

Aviso

Este proyecto no está afiliado ni avalado por ninguna universidad ni por el SIU. Usalo bajo tu responsabilidad.