# unlam-mcp: servidor MCP para MIeL e Intraconsulta (UNLaM)

Servidor MCP gratis y de código abierto que conecta Claude, Cursor y otros asistentes de IA con MIeL e Intraconsulta de la UNLaM.

- Sitio: https://unlam-mcp.vercel.app
- Código: https://github.com/blasestevez/unlam-mcp
- Paquete: https://pypi.org/project/unlam-mcp/ (versión 0.1.1)
- Actualizado: 2026-11-19
- Autor: Blas Estevez (https://github.com/blasestevez)
- Licencia: MIT (gratis)
- Requisitos: [uv](https://docs.astral.sh/uv/getting-started/installation/) y un cliente MCP de escritorio con transporte STDIO.
- Proyecto independiente y no oficial, sin relación con la UNLaM.

## Qué hace

unlam-mcp conecta tu asistente de IA con MIeL, el campus virtual de la Universidad Nacional de La Matanza, y con Intraconsulta. Le das acceso a 27 herramientas para que responda en lenguaje natural sobre tus materias. Casi todas son de solo lectura; las únicas operaciones de escritura (reservar y cancelar turnos, enviar mensajes y entregar prácticas) se ejecutan solo a pedido del usuario y se verifican con una nueva lectura de MIeL.

## Ejemplos de preguntas

- "¿Qué contenidos se publicaron esta semana en Programación Avanzada?" (usa `miel_contenidos`)
- "Descargá el programa de Base de Datos." (usa `miel_descargar`)
- "¿Qué respondió el docente en el foro del TP?" (usa `miel_foro_tema`)
- "Resumí el apunte de la unidad 3 de Redes." (usa `miel_leer`)
- "¿Cuándo son los recuperatorios?" (usa `miel_calendario`)
- "¿Cuál es mi asistencia en Redes?" (usa `miel_asistencia`)
- "Reservá el turno de las 18 h del recuperatorio." (usa `miel_reservar_turno`)
- "Enviá un mensaje a mi grupo de Taller Web con el informe adjunto." (usa `miel_enviar_mensaje`)
- "Entregá este PDF en el TP 1 de Base de Datos." (usa `miel_entregar_practica`)

## Herramientas

### MIeL

- `miel_novedades`: Archivos nuevos, mensajes sin leer y foros con actividad de todas las materias.
- `miel_materias`: Tus materias, con comisión y elementos pendientes.
- `miel_calendario`: Parciales, recuperatorios, entregas y defensas, con fecha, lugar y horario.
- `miel_contenidos`: Archivos y enlaces publicados por los docentes, con carpeta y fecha.
- `miel_leer`: Extrae el texto de un apunte en PDF, Word, PowerPoint o texto plano.
- `miel_ver_pagina`: Renderiza una página de un PDF como imagen, para escaneos y fórmulas.
- `miel_descargar`: Descarga un archivo o el adjunto de un mensaje a tu equipo.
- `miel_foro`: Temas del foro de una materia, con mensajes sin leer.
- `miel_foro_tema`: Mensajes de un tema del foro.
- `miel_mensajes`: Avisos y correcciones de los docentes en la bandeja de la materia.
- `miel_mensaje`: Contenido completo de un mensaje, con sus adjuntos.
- `miel_destinatarios`: Docentes, compañeros y grupo a los que podés escribir.
- `miel_practicas`: Trabajos prácticos y parciales: vencimiento, entrega, corrección y nota.
- `miel_asistencia`: Asistencia por clase y notas de las evaluaciones online.
- `miel_grupos`: Grupos de trabajo de cada materia, con sus integrantes.
- `miel_evaluaciones`: Evaluaciones online y su estado de habilitación. Solo las lista.
- `miel_turnos`: Turnos de recuperatorios y consultas: fecha, lugar y vacantes.

### Intraconsulta

Usa el mismo DNI y clave de MIeL.

- `intraconsulta_materias_en_curso`: Materias del cuatrimestre: comisión, horario, aula y modalidad.
- `intraconsulta_historia_academica`: Materias aprobadas con nota, fecha y acta, y tu promedio.
- `intraconsulta_descargar_historia_academica`: Descarga el PDF de tu historia académica, sin costo.
- `intraconsulta_regularizadas`: Materias con cursada aprobada y final pendiente.
- `intraconsulta_constancias`: Mesas de final con constancia de examen disponible.
- `intraconsulta_descargar_constancia`: Descarga la constancia de examen en PDF, sin costo.

### Acciones

Las únicas operaciones de escritura. Se ejecutan solo cuando vos lo pedís y se verifican después.

- `miel_reservar_turno`: Reserva un turno y avisa si reemplaza una reserva previa.
- `miel_cancelar_turno`: Cancela un turno reservado y libera la vacante.
- `miel_enviar_mensaje`: Envía un mensaje a docentes o a tu grupo, con un adjunto de hasta 40 MB.
- `miel_entregar_practica`: Entrega un trabajo práctico subiendo un archivo de hasta 40 MB.

## Instalación

### 1. Guardar las credenciales

```bash
uvx unlam-mcp login
```

Solicita el usuario y la clave de MIeL, valida el acceso y los guarda en el gestor de credenciales del sistema operativo. Para borrarlos: `uvx unlam-mcp logout`.

### 2. Registrar el servidor en el cliente

El comando de inicio es `uvx unlam-mcp` en todos los clientes.

### Claude Code

```bash
claude mcp add unlam -- uvx unlam-mcp
```

### Codex

```bash
codex mcp add unlam -- uvx unlam-mcp
```

### Cursor

En `~/.cursor/mcp.json`:

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

### Gemini CLI

En `~/.gemini/settings.json`:

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

### Antigravity

En `MCP Servers → Manage → View raw config`:

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

### OpenCode

En `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "unlam": {
      "type": "local",
      "command": ["uvx", "unlam-mcp"],
      "enabled": true
    }
  }
}
```

## Preguntas frecuentes

### ¿Qué es unlam-mcp?

Es un servidor MCP (Model Context Protocol) de código abierto que expone MIeL, el campus virtual de la UNLaM, e Intraconsulta como herramientas para asistentes de IA. Con él podés preguntarle a Claude, Cursor o Copilot por tus materias, entregas, notas y foros en lenguaje natural.

### ¿Qué es un servidor MCP?

MCP (Model Context Protocol) es un estándar abierto para que los asistentes de IA usen herramientas externas. Un servidor MCP le da al asistente funciones concretas, como leer tus contenidos de MIeL, que el modelo llama cuando las necesita para responderte.

### ¿Qué es MIeL?

MIeL (Materias Interactivas en Línea) es el campus virtual de la Universidad Nacional de La Matanza (UNLaM), donde los docentes publican apuntes, avisos, foros, trabajos prácticos y turnos. Intraconsulta es el sistema de inscripción e historia académica, y se usa con el mismo DNI y clave.

### ¿Qué necesito para instalarlo?

Solo uv y un cliente MCP de escritorio. uv descarga Python 3.12 o superior y las dependencias la primera vez que ejecutás "uvx unlam-mcp", así que no hace falta instalar Python a mano. Después guardás tu usuario y clave de MIeL con "uvx unlam-mcp login" y registrás el servidor en tu cliente.

### ¿Es un proyecto oficial de la UNLaM?

No. unlam-mcp es un proyecto independiente y no oficial, sin relación con la UNLaM. Su uso debe ser moderado y respetar el aviso legal de MIeL.

### ¿Dónde se guardan mi usuario y mi clave?

En el gestor de credenciales de tu sistema operativo: el Administrador de credenciales en Windows, el Llavero en macOS o Secret Service en Linux. No se guardan en archivos de texto ni en la configuración del cliente, y el servidor corre en tu computadora, así que las credenciales no salen de tu equipo.

### ¿Puede publicar en el foro o hacer cosas sin que yo lo pida?

No. Casi todas las herramientas son de solo lectura. Las únicas operaciones de escritura son reservar y cancelar turnos, enviar mensajes y entregar prácticas, y solo se ejecutan a pedido tuyo. El servidor no publica en el foro ni inicia evaluaciones, y después de cada operación vuelve a leer MIeL para verificar el resultado.

### ¿Con qué asistentes de IA funciona?

Con cualquier cliente MCP de escritorio que soporte servidores locales por STDIO: Claude Code, Claude Desktop, Cursor, VS Code con Copilot, Windsurf, Codex, Gemini CLI, LM Studio, Cline y Zed, entre otros.

### ¿Cuánto cuesta?

Nada. Es software libre con licencia MIT. Las descargas de historia académica y constancias de examen tampoco tienen costo; los certificados arancelados de Intraconsulta no se solicitan desde el servidor.

### En Windows el cliente no encuentra uvx, ¿qué hago?

Algunos clientes no heredan el PATH de la terminal. Ejecutá "where uvx" y poné la ruta absoluta del ejecutable en el campo "command" de la configuración.
