cvuex-mcp

Tu Campus Virtual de la UEx, dentro de tu asistente de IA.

Conecta asistentes como Claude Code o Codex con tus aulas de AVUEx para que puedas preguntarles en lenguaje natural: "¿qué tengo que entregar esta semana?", "¿hay avisos nuevos?" o "explícame este concepto según los apuntes".

Funciona en tu equipo, con tu propia cuenta, y solo consulta: no envía, publica ni entrega nada por ti.

IMPORTANTE: este proyecto no es oficial y no lo desarrolla ni lo respalda la Universidad de Extremadura.

Qué puedes preguntarle

¿Qué tengo que hacer?

• "¿Qué tengo que entregar esta semana?"

• "¿Qué tareas me quedan por entregar?"

• "Pásame los plazos a Google Calendar."

¿Cómo voy?

• "¿Qué nota llevo en cada asignatura?"

• "Explícame los fallos de mi último cuestionario de Estadística."

¿Qué hay de nuevo?

• "¿Hay avisos nuevos de los profesores?"

• "¿Qué ha cambiado en el campus desde la última vez?"

• "¿Alguien ha preguntado ya en el foro por la práctica 2?"

Ayúdame con el temario

• "¿Qué hay en el tema 3 de Redes?"

• "Descárgate los apuntes de mis asignaturas."

• "¿Dónde explica el profesor el algoritmo de Dijkstra?"

• "Explícame la normalización según los apuntes." El asistente cita el documento y la página.

Mis asignaturas y profesores

• "¿Qué asignaturas tengo este curso?"

• "¿Quién da Programación y cómo le escribo?"

Related MCP server: MCP-TUPAD

Instalación

Necesitas uv, que se encarga también de instalar Python, y git. Funciona en Linux, macOS y Windows.

Instalación rápida

Copia este mensaje en tu asistente (Claude Code, Codex, OpenCode u otro que admita servidores MCP) y te guiará por todo el proceso:

Instala el servidor MCP cvuex-mcp (Campus Virtual de la UEx) en este asistente:
1. Comprueba que uv y git están instalados. Si falta alguno, dime cómo instalarlo
   en mi sistema y espera a que lo haga.
2. Ejecuta: uvx --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp login
   Abre el navegador para que inicie sesión con mi cuenta de la UEx y termina
   cuando lo haya hecho, lo que puede llevar unos minutos. Si no puedes esperar
   tanto, pídeme que lo ejecute yo en una terminal.
3. Ejecuta: uvx --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp whoami
   Debe mostrar mi nombre.
4. Configura en este asistente un servidor MCP local (stdio) llamado "cvuex":
   - Comando: uvx
   - Argumentos: --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp serve
   - No necesita variables de entorno ni claves: la sesión queda guardada en mi equipo.
   - Si hay un límite de tiempo por llamada, que sea de al menos 15 segundos.
   Busca en la documentación de este asistente cómo se añaden servidores MCP.
5. Dime si tengo que reiniciarte y, después, comprueba que funciona con su
   herramienta quien_soy.

Instalación manual

1. Inicia sesión.

   uvx --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp login

   Se abrirá Google Chrome o Microsoft Edge para guardar tus credenciales.

2. Comprueba que funciona: debe mostrar tu nombre.

   uvx --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp whoami

3. Conéctalo a tu asistente con una de estas opciones. Después, reinicia el asistente y pregúntale "¿Con qué cuenta del campus estás conectado?" para comprobar que la configuración fue exitosa.

   Claude Code

   claude mcp add --scope user cvuex -- uvx --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp serve

   Codex CLI

   codex mcp add cvuex -- uvx --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp serve

   OpenCode: añade esto a ~/.config/opencode/opencode.json:

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "cvuex": {
         "type": "local",
         "command": ["uvx", "--from", "git+https://github.com/rdereparadores/cvuex-mcp", "cvuex-mcp", "serve"],
         "enabled": true,
         "timeout": 15000
       }
     }
   }

Tus archivos

• Apuntes: se descargan en la carpeta Documentos/CVUEx, ordenados por asignatura y tema. Cada vez solo baja lo nuevo o lo que ha cambiado. Si el profesor quita un fichero del campus, conservas tu copia, y nunca toca lo que pongas tú en la carpeta.

• Calendario: calendario.ics se guarda en esa misma carpeta. Si cambian los plazos, vuelve a exportarlo.

• Tu sesión queda guardada en tu equipo y da acceso a tu cuenta del campus. Si usas un ordenador compartido, ciérrala con la orden logout.

Órdenes de la terminal

Todas se escriben tras uvx --from git+https://github.com/rdereparadores/cvuex-mcp cvuex-mcp, como en la instalación.

Si las usas a menudo, instala la orden una vez con uv tool install git+https://github.com/rdereparadores/cvuex-mcp y escribe solo cvuex-mcp login, cvuex-mcp calendario… En ese caso, se actualiza con uv tool upgrade cvuex-mcp.

Si algo no va

• "La sesión ha caducado" o "no hay sesión": vuelve a iniciar sesión con la orden login. No hace falta reiniciar el asistente.

• La búsqueda en los apuntes no encuentra nada: busca palabras, no significados. Prueba con sinónimos o en inglés, que es el idioma de algunos materiales. Los PDF escaneados y los formatos antiguos .doc y .ppt no se pueden buscar: la descarga te avisa de cuáles son para que los abras tú.

• La descarga o la búsqueda en los foros tarda: siguen en segundo plano. Vuelve a preguntar al cabo de un rato por cómo va.

• No aparecen las tutorías de un profesor: solo salen si las pone en su perfil del campus; si no, están en la guía docente de la asignatura.

Herramientas disponibles

Desarrollo

¿Quieres revisar o modificar el código? Mira DESARROLLO.md.

Licencia

MIT.