Servidor MCP de MyCourseVille

Un servidor MCP que da acceso a un agente de IA a tu cuenta de MyCourseVille: nuevas tareas con sus fechas límite y descripciones, materiales del curso y calificaciones publicadas, además de un feed de "qué ha cambiado desde la última vez".

Una herramienta personal para los datos de tu propia cuenta. Mantén el intervalo de sondeo moderado y nunca hagas commit de tus credenciales.

Cómo funciona

MCV tiene una API OAuth2 oficial (/api/v1/public/get/*), pero requiere registrar una aplicación para obtener un client_id/client_secret, y sus nombres de endpoint no están documentados públicamente. Este servidor, en cambio, inicia sesión exactamente igual que el cliente web de MCV: a través del botón de IT Chula SSO por defecto, o con el formulario normal de MCV. Después lee las mismas páginas de curso procesadas por el servidor que el sitio muestra a un navegador: la página de inicio del curso para materiales, /assignment para fechas límite y /portfolio-<student id> para puntuaciones. Consulta docs/ENDPOINTS.md.

Los datos obtenidos se guardan en una instantánea local de SQLite. Cada sincronización compara los cambios con esa instantánea y agrega registros a un log de events — ese log es lo que lee whats_new, para que el servidor pueda decirte qué apareció desde la última vez que miraste. Un sondeo en segundo plano se actualiza en un intervalo, por lo que se detecta una nueva tarea incluso si no hay ningún chat abierto.

Sobre "nuevo": MCV no expone de forma confiable una marca de tiempo de publicación, así que first_seen —cuando este servidor observó un elemento por primera vez— se usa como sustituto. La primera sincronización completa los datos en silencio, en lugar de reportar todo tu semestre como nuevo.

Related MCP server: UofT Student Helper MCP Server

Instalación

uv sync --extra dev
cp .env.example .env      # then fill in MCV_USERNAME / MCV_PASSWORD
uv run mcv-mcp --selftest

--selftest inicia sesión, sincroniza una vez e imprime cuántos cursos, tareas, materiales y calificaciones encontró. Asegúrate de que funcione antes de conectar el agente.

Registra con Claude Code:

claude mcp add mcv -- uv --directory C:\Users\velys\Documents\mcp_mcv run mcv-mcp

Luego pregunta: "¿Qué tengo que entregar esta semana?", "¿Hay algo nuevo en MCV desde ayer?", "Descarga las últimas diapositivas de Comp Prog."

Herramientas

Configuración

El estado se mantiene fuera del repositorio. Las cookies se conservan, por lo que los reinicios no requieren volver a iniciar sesión.

Ejecuta el sondeo por separado (por ejemplo, con el Programador de tareas) usando:

uv run python -m mcv_mcp.poller

Estructura

src/mcv_mcp/
  config.py    settings, URLs, state paths
  client.py    Chula SSO login, cookie persistence, throttled AJAX transport
  parsers.py   HTML -> dicts (pure functions, fixture-tested)
  store.py     SQLite snapshot + event log
  sync.py      orchestration + background poller
  server.py    MCP tool definitions

El marcado de MCV es la parte frágil y está confinado a parsers.py. Si algo deja de devolver filas, captura una copia de una prueba nueva (consulta docs/ENDPOINTS.md) y corrige el selector allí.

Estado

Funciona con una cuenta real: inicio de sesión, los cuatro analizadores, descargas y detección de cambios están verificados de extremo a extremo. Una sincronización representativa obtuvo 9 cursos, 20 tareas (todas con fecha límite analizada), 112 materiales y 69 elementos calificados; la siguiente sincronización reportó cero cambios, por lo que el registro de diferencias se mantiene en silencio hasta que algo realmente se mueva.

Limitaciones conocidas:

• La publicación de calificaciones se detecta por sondeo, no por notificación. La aparición deuna calificación se muestra como un evento grade_changed dentro de un intervalo de sondeo (por defecto, 30 minutos).

• Solo se sincroniza el semestre actual, a menos que pases full=true a sync_now.

• El marcado de MCV es la parte frágil. Si un analizador comienza a devolver cero filas, captura una una prueba y corrige el selector; consulta docs/ENDPOINTS.md.

Desarrollo

uv run pytest