Skip to main content

unlam-mcp

Servidor MCP (Model Context Protocol) para la UNLaM. Expone MIeL (el campus virtual) e Intraconsulta como herramientas para asistentes de IA, de modo que el estudiante pueda consultar sus materias en lenguaje natural. Es compatible con cualquier cliente MCP: Claude, Cursor, VS Code (Copilot), Windsurf, Codex, Gemini CLI, entre otros.

Ejemplos de consultas:

  • "¿Qué contenidos se publicaron esta semana en Programación Avanzada?"
  • "Descargá el programa de Base de Datos."
  • "¿Qué respondió el docente en el foro del TP?"
  • "¿Qué entregas tengo esta semana y qué notas me asignaron?"
  • "¿Hay novedades en MIeL?"
  • "Resumí el apunte de la unidad 3 de Redes."
  • "¿Cuándo son los recuperatorios?"
  • "¿Cuál es mi asistencia en Redes?"
  • "Reservá el turno de las 18 h del recuperatorio."
  • "Enviá un mensaje a mi grupo de Taller Web con el informe adjunto."
  • "Entregá este PDF en el TP 1 de Base de Datos."
  • "¿Cuál es mi promedio y cuántas materias tengo aprobadas?"

Herramientas

Consulta (MIeL)

Herramienta Descripción
miel_novedades Novedades de todas las materias: archivos nuevos, mensajes sin leer y foros con actividad.
miel_materias Materias del usuario, con comisión y elementos pendientes.
miel_calendario Parciales, recuperatorios, entregas y defensas de todas las materias, con fecha, lugar y horario.
miel_contenidos Archivos y enlaces publicados por los docentes, con carpeta, fecha e indicador de novedad.
miel_leer Extrae el texto de un apunte (PDF, Word, PowerPoint o texto plano) para su análisis.
miel_ver_pagina Renderiza una página de un PDF como imagen, para documentos escaneados, gráficos o fórmulas.
miel_descargar Descarga un archivo, o el adjunto de un mensaje, al equipo local.
miel_foro Temas del foro de una materia, con cantidad de mensajes sin leer.
miel_foro_tema Mensajes de un tema del foro.
miel_mensajes Bandeja de mensajes de una materia: avisos y correcciones de los docentes.
miel_mensaje Contenido completo de un mensaje, con sus adjuntos.
miel_destinatarios Destinatarios disponibles en una materia: docentes, compañeros y grupo.
miel_practicas Trabajos prácticos y parciales: vencimiento, estado de entrega, estado de corrección y nota. Por materia o para todas.
miel_asistencia Asistencia por clase con resumen, y notas de las evaluaciones online.
miel_grupos Grupos de trabajo de cada materia, con sus integrantes.
miel_evaluaciones Evaluaciones online de una materia y su estado de habilitación. Solo las lista.
miel_turnos Turnos de una materia (recuperatorios, consultas): fecha, lugar, vacantes y estado de la reserva.

Consulta (Intraconsulta)

Utiliza las mismas credenciales que MIeL (DNI y clave) para acceder a Intraconsulta:

Herramienta Descripción
intraconsulta_materias_en_curso Materias inscriptas en el cuatrimestre actual: comisión, día y horario, aula y modalidad.
intraconsulta_historia_academica Materias aprobadas con nota, fecha, acta y origen (promoción, examen o equivalencia), y el promedio simple calculado sobre ellas.
intraconsulta_descargar_historia_academica Descarga el PDF de la historia académica en MIEL_CARPETA/Intraconsulta. No tiene costo ni inicia ningún trámite.
intraconsulta_regularizadas Materias con cursada aprobada y examen final pendiente.
intraconsulta_constancias Materias o mesas de final para las que hay constancia de examen disponible.
intraconsulta_descargar_constancia Descarga la constancia de examen en PDF en MIEL_CARPETA/Intraconsulta. No tiene costo ni inicia ningún trámite.

Los certificados de Intraconsulta (alumno regular, materias aprobadas, analítico parcial) son trámites arancelados, por lo que este servidor no los solicita ni los lista. Deben gestionarse desde Intraconsulta.

Operaciones de escritura

Herramienta Descripción
miel_reservar_turno Reserva un turno. Si existe una reserva previa para el mismo evento, MIeL la cancela; el asistente lo informa antes de ejecutar la operación.
miel_cancelar_turno Cancela un turno reservado y libera la vacante.
miel_enviar_mensaje Envía un mensaje por la mensajería de la materia, con un adjunto opcional (máximo 40 MB). Los destinatarios se indican por nombre o por grupo.
miel_entregar_practica Entrega un trabajo práctico del portafolio mediante la carga de un archivo (máximo 40 MB).

Luego de cada operación, el servidor vuelve a consultar MIeL para verificar el resultado. Si el cambio no se refleja, se informa el error en lugar de asumir que la operación fue exitosa. El envío de mensajes y las entregas son irreversibles.

Algunas consultas modifican el estado de lectura en MIeL, igual que al navegar desde el sitio: abrir un mensaje o un tema del foro los marca como leídos, y listar los contenidos quita el indicador de novedad.

El parámetro materia acepta el nombre completo o parcial ("prog avanzada", "base de datos") o el código de la materia (3630), sin distinción de acentos.

Instalación

Requisitos

  • uv (gestiona Python y las dependencias).
  • Un cliente compatible con servidores MCP locales por transporte STDIO.

1. Configurar credenciales

uvx unlam-mcp login

El comando solicita el usuario y la clave de MIeL, valida el acceso y almacena las credenciales en el gestor de credenciales del sistema operativo (Administrador de credenciales en Windows, Llavero en macOS, Secret Service en Linux). Las credenciales no se guardan en archivos de texto ni en la configuración del cliente.

Si la clave de MIeL cambia, se debe ejecutar login nuevamente. Para eliminar las credenciales almacenadas: uvx unlam-mcp logout.

2. Registrar el servidor en el cliente

En todos los clientes, el comando de inicio es uvx unlam-mcp.

Claude Code
claude mcp add unlam -- uvx unlam-mcp
Claude Desktop

En Settings → Developer → Edit Config, agregar:

{
  "mcpServers": {
    "unlam": {
      "command": "uvx",
      "args": ["unlam-mcp"]
    }
  }
}

Reiniciar Claude Desktop para aplicar los cambios.

Cursor

En ~/.cursor/mcp.json (o desde Settings → MCP → Add new server):

{
  "mcpServers": {
    "unlam": {
      "command": "uvx",
      "args": ["unlam-mcp"]
    }
  }
}
VS Code (Copilot)
code --add-mcp "{\"name\":\"unlam\",\"command\":\"uvx\",\"args\":[\"unlam-mcp\"]}"

Alternativamente, en .vscode/mcp.json (o desde MCP: Open User Configuration):

{
  "servers": {
    "unlam": {
      "type": "stdio",
      "command": "uvx",
      "args": ["unlam-mcp"]
    }
  }
}

Las herramientas están disponibles en el chat en modo Agent.

Windsurf

En ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "unlam": {
      "command": "uvx",
      "args": ["unlam-mcp"]
    }
  }
}
Codex (CLI y extensión)
codex mcp add unlam -- uvx unlam-mcp

Alternativamente, en ~/.codex/config.toml:

[mcp_servers.unlam]
command = "uvx"
args = ["unlam-mcp"]
Gemini CLI

En ~/.gemini/settings.json:

{
  "mcpServers": {
    "unlam": {
      "command": "uvx",
      "args": ["unlam-mcp"]
    }
  }
}
Otros clientes (LM Studio, Cline, Zed, etc.)

La mayoría de los clientes utiliza el mismo bloque mcpServers, con "command": "uvx" y "args": ["unlam-mcp"]. Consultar la documentación del cliente para conocer la ubicación del archivo de configuración.

Notas de compatibilidad

  • Windows: si el cliente no encuentra uvx, indicar la ruta absoluta del ejecutable en command (se obtiene con where uvx). Algunos clientes no heredan el PATH de la terminal.
  • ChatGPT y clientes web: solo admiten servidores MCP remotos (HTTP). Este servidor se ejecuta localmente para que las credenciales no salgan del equipo, por lo que requiere un cliente de escritorio o un editor.
  • Contenido de imagen: miel_ver_pagina devuelve imágenes. En clientes sin soporte para imágenes, el resto de las herramientas funciona con normalidad.
  • Versión de desarrollo: para usar la última versión del repositorio en lugar de la publicada en PyPI, reemplazar uvx unlam-mcp por uvx --from git+https://github.com/blasestevez/unlam-mcp unlam-mcp.

Variables de entorno

Variable Valor por defecto Descripción
MIEL_CARPETA ~/MIeL Directorio de destino de las descargas.
MIEL_USUARIO, MIEL_CLAVE Las credenciales de login Credenciales alternativas, para entornos sin gestor de credenciales (por ejemplo, un servidor).

Al ejecutar el proyecto desde una copia local (uv run unlam-mcp), las variables también pueden definirse en un archivo .env (ver .env.example).

Desarrollo

Estructura

src/unlam_mcp/
├── server.py         # definición de las herramientas MCP
├── miel.py           # cliente HTTP de MIeL: autenticación, páginas y descargas
├── parsers.py        # parseo del HTML de MIeL a estructuras de datos
├── intraconsulta.py  # cliente de la API JSON de Intraconsulta
└── archivos.py       # extracción de texto de PDF, Word y PowerPoint, y renderizado de páginas

Para ejecutar desde el código fuente: clonar el repositorio y ejecutar uv run unlam-mcp.

Arquitectura

MIeL no expone una API de datos: las páginas se generan del lado del servidor, por lo que la información se obtiene parseando el HTML. Las operaciones de escritura utilizan los mismos formularios que el sitio (por ejemplo /turnos/event/reservarTurno/, /mensajeria/event/enviarMensaje/ o /portafolio/event/nuevaEntrega/), y cada una se verifica con una nueva lectura de la página.

Intraconsulta dispone de una API JSON (/backend/api/), pero la autenticación de alumnos se realiza a través de la versión anterior (alumno2.unlam.edu.ar). Esta redirige a la versión nueva con un transferToken, que se intercambia en Login/system-login por la cookie de sesión.

Agregar una herramienta

  1. El parser de la página va en parsers.py.
  2. El método que realiza la solicitud va en MielClient (miel.py).
  3. La herramienta va en server.py, con el nombre miel_<accion>.

El docstring de la herramienta es la descripción que recibe el modelo: debe indicar su propósito y el origen de cada parámetro.

Ante un fallo en una herramienta existente, la causa más probable es un cambio en el HTML de MIeL; la corrección corresponde a parsers.py.

Hoja de ruta

  • Intraconsulta: inscripción a materias y a mesas de final.

Créditos

Basado en TBalles/miel-mcp y nialvape/utn-mcp.

El uso de este servidor debe ser moderado y respetar el aviso legal de MIeL.

Licencia

MIT

Metadata

Release files for unlam-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unlam-mcp 0.1.0
File Size Uploaded Provenance Actions
unlam_mcp-0.1.0.tar.gz 36.0 kB Without provenance Details for unlam_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for unlam-mcp 0.1.0
File Interpreter ABI Platform Actions
unlam_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for unlam_mcp-0.1.0-py3-none-any.whl

Total release size: 75.0 kB

Release files / unlam_mcp-0.1.0.tar.gz

Download URL unlam_mcp-0.1.0.tar.gz
Size 36.0 kB
Tags Source
SHA-256 checksum
How to use checksums
2a362be7797e7e793556243c27ad7fedb6e6d75dc4bc7e92644d05f390f6fc46
BLAKE2b-256 checksum
How to use checksums
fe8cfb90116f67d45a5f1e86c9ad26dda0a4c23ed46e3ed882837019aba813f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / unlam_mcp-0.1.0-py3-none-any.whl

Download URL unlam_mcp-0.1.0-py3-none-any.whl
Size 39.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
882d2c6738bcda40263a117f15af5e8d09959fd7df4b9c5d2a2466cef4f5cb51
BLAKE2b-256 checksum
How to use checksums
58a68ad0001afbdb2c44df9607ea48d3602d591f3217eae6b7304e8c8e0a7b9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for unlam-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page