unlam-mcp 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- unlam_mcp-0.1.0/LICENSE +21 -0
- unlam_mcp-0.1.0/PKG-INFO +315 -0
- unlam_mcp-0.1.0/README.md +283 -0
- unlam_mcp-0.1.0/pyproject.toml +55 -0
- unlam_mcp-0.1.0/pyproject.toml.orig +45 -0
- unlam_mcp-0.1.0/src/unlam_mcp/__init__.py +3 -0
- unlam_mcp-0.1.0/src/unlam_mcp/archivos.py +207 -0
- unlam_mcp-0.1.0/src/unlam_mcp/intraconsulta.py +338 -0
- unlam_mcp-0.1.0/src/unlam_mcp/miel.py +580 -0
- unlam_mcp-0.1.0/src/unlam_mcp/parsers.py +760 -0
- unlam_mcp-0.1.0/src/unlam_mcp/server.py +690 -0
unlam_mcp-0.1.0/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Blas
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
unlam_mcp-0.1.0/PKG-INFO
ADDED
|
@@ -0,0 +1,315 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: unlam-mcp
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Servidor MCP para la UNLaM: MIeL e Intraconsulta desde cualquier asistente con MCP (Claude, Cursor, VS Code, Codex, Gemini CLI...).
|
|
5
|
+
Keywords: mcp,mcp-server,model-context-protocol,unlam,miel,intraconsulta,universidad,argentina
|
|
6
|
+
Author: Blas
|
|
7
|
+
Author-email: Blas <126523540+blasestevez@users.noreply.github.com>
|
|
8
|
+
License-Expression: MIT
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Classifier: Development Status :: 4 - Beta
|
|
11
|
+
Classifier: Environment :: Console
|
|
12
|
+
Classifier: Intended Audience :: Education
|
|
13
|
+
Classifier: Natural Language :: Spanish
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
17
|
+
Classifier: Topic :: Education
|
|
18
|
+
Requires-Dist: beautifulsoup4>=4.12
|
|
19
|
+
Requires-Dist: httpx>=0.28
|
|
20
|
+
Requires-Dist: keyring>=25.7.0
|
|
21
|
+
Requires-Dist: mcp>=2.3,<3
|
|
22
|
+
Requires-Dist: pillow>=13.0.0
|
|
23
|
+
Requires-Dist: pydantic-settings>=2.6
|
|
24
|
+
Requires-Dist: pypdfium2>=5.15.2
|
|
25
|
+
Requires-Dist: python-docx>=1.2.0
|
|
26
|
+
Requires-Dist: python-pptx>=1.0.2
|
|
27
|
+
Requires-Python: >=3.12
|
|
28
|
+
Project-URL: Homepage, https://github.com/blasestevez/unlam-mcp
|
|
29
|
+
Project-URL: Repository, https://github.com/blasestevez/unlam-mcp
|
|
30
|
+
Project-URL: Issues, https://github.com/blasestevez/unlam-mcp/issues
|
|
31
|
+
Description-Content-Type: text/markdown
|
|
32
|
+
|
|
33
|
+
# unlam-mcp
|
|
34
|
+
|
|
35
|
+
Servidor [MCP](https://modelcontextprotocol.io) (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.
|
|
36
|
+
|
|
37
|
+
Ejemplos de consultas:
|
|
38
|
+
|
|
39
|
+
- *"¿Qué contenidos se publicaron esta semana en Programación Avanzada?"*
|
|
40
|
+
- *"Descargá el programa de Base de Datos."*
|
|
41
|
+
- *"¿Qué respondió el docente en el foro del TP?"*
|
|
42
|
+
- *"¿Qué entregas tengo esta semana y qué notas me asignaron?"*
|
|
43
|
+
- *"¿Hay novedades en MIeL?"*
|
|
44
|
+
- *"Resumí el apunte de la unidad 3 de Redes."*
|
|
45
|
+
- *"¿Cuándo son los recuperatorios?"*
|
|
46
|
+
- *"¿Cuál es mi asistencia en Redes?"*
|
|
47
|
+
- *"Reservá el turno de las 18 h del recuperatorio."*
|
|
48
|
+
- *"Enviá un mensaje a mi grupo de Taller Web con el informe adjunto."*
|
|
49
|
+
- *"Entregá este PDF en el TP 1 de Base de Datos."*
|
|
50
|
+
- *"¿Cuál es mi promedio y cuántas materias tengo aprobadas?"*
|
|
51
|
+
|
|
52
|
+
> [!NOTE]
|
|
53
|
+
> Proyecto no oficial, sin relación con la UNLaM. La mayoría de las herramientas son de solo lectura. Las únicas operaciones de escritura son **reservar y cancelar turnos, enviar mensajes y entregar prácticas**, y se ejecutan únicamente a pedido del usuario. El foro y las evaluaciones son de solo lectura: el servidor no publica en el foro ni inicia evaluaciones.
|
|
54
|
+
|
|
55
|
+
## Herramientas
|
|
56
|
+
|
|
57
|
+
### Consulta (MIeL)
|
|
58
|
+
|
|
59
|
+
| Herramienta | Descripción |
|
|
60
|
+
|---|---|
|
|
61
|
+
| `miel_novedades` | Novedades de todas las materias: archivos nuevos, mensajes sin leer y foros con actividad. |
|
|
62
|
+
| `miel_materias` | Materias del usuario, con comisión y elementos pendientes. |
|
|
63
|
+
| `miel_calendario` | Parciales, recuperatorios, entregas y defensas de todas las materias, con fecha, lugar y horario. |
|
|
64
|
+
| `miel_contenidos` | Archivos y enlaces publicados por los docentes, con carpeta, fecha e indicador de novedad. |
|
|
65
|
+
| `miel_leer` | Extrae el texto de un apunte (PDF, Word, PowerPoint o texto plano) para su análisis. |
|
|
66
|
+
| `miel_ver_pagina` | Renderiza una página de un PDF como imagen, para documentos escaneados, gráficos o fórmulas. |
|
|
67
|
+
| `miel_descargar` | Descarga un archivo, o el adjunto de un mensaje, al equipo local. |
|
|
68
|
+
| `miel_foro` | Temas del foro de una materia, con cantidad de mensajes sin leer. |
|
|
69
|
+
| `miel_foro_tema` | Mensajes de un tema del foro. |
|
|
70
|
+
| `miel_mensajes` | Bandeja de mensajes de una materia: avisos y correcciones de los docentes. |
|
|
71
|
+
| `miel_mensaje` | Contenido completo de un mensaje, con sus adjuntos. |
|
|
72
|
+
| `miel_destinatarios` | Destinatarios disponibles en una materia: docentes, compañeros y grupo. |
|
|
73
|
+
| `miel_practicas` | Trabajos prácticos y parciales: vencimiento, estado de entrega, estado de corrección y nota. Por materia o para todas. |
|
|
74
|
+
| `miel_asistencia` | Asistencia por clase con resumen, y notas de las evaluaciones online. |
|
|
75
|
+
| `miel_grupos` | Grupos de trabajo de cada materia, con sus integrantes. |
|
|
76
|
+
| `miel_evaluaciones` | Evaluaciones online de una materia y su estado de habilitación. Solo las lista. |
|
|
77
|
+
| `miel_turnos` | Turnos de una materia (recuperatorios, consultas): fecha, lugar, vacantes y estado de la reserva. |
|
|
78
|
+
|
|
79
|
+
### Consulta (Intraconsulta)
|
|
80
|
+
|
|
81
|
+
Utiliza las mismas credenciales que MIeL (DNI y clave) para acceder a [Intraconsulta](https://intraconsulta.unlam.edu.ar):
|
|
82
|
+
|
|
83
|
+
| Herramienta | Descripción |
|
|
84
|
+
|---|---|
|
|
85
|
+
| `intraconsulta_materias_en_curso` | Materias inscriptas en el cuatrimestre actual: comisión, día y horario, aula y modalidad. |
|
|
86
|
+
| `intraconsulta_historia_academica` | Materias aprobadas con nota, fecha, acta y origen (promoción, examen o equivalencia), y el promedio simple calculado sobre ellas. |
|
|
87
|
+
| `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. |
|
|
88
|
+
| `intraconsulta_regularizadas` | Materias con cursada aprobada y examen final pendiente. |
|
|
89
|
+
| `intraconsulta_constancias` | Materias o mesas de final para las que hay constancia de examen disponible. |
|
|
90
|
+
| `intraconsulta_descargar_constancia` | Descarga la constancia de examen en PDF en `MIEL_CARPETA/Intraconsulta`. No tiene costo ni inicia ningún trámite. |
|
|
91
|
+
|
|
92
|
+
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.
|
|
93
|
+
|
|
94
|
+
### Operaciones de escritura
|
|
95
|
+
|
|
96
|
+
| Herramienta | Descripción |
|
|
97
|
+
|---|---|
|
|
98
|
+
| `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. |
|
|
99
|
+
| `miel_cancelar_turno` | Cancela un turno reservado y libera la vacante. |
|
|
100
|
+
| `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. |
|
|
101
|
+
| `miel_entregar_practica` | Entrega un trabajo práctico del portafolio mediante la carga de un archivo (máximo 40 MB). |
|
|
102
|
+
|
|
103
|
+
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.
|
|
104
|
+
|
|
105
|
+
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.
|
|
106
|
+
|
|
107
|
+
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.
|
|
108
|
+
|
|
109
|
+
## Instalación
|
|
110
|
+
|
|
111
|
+
### Requisitos
|
|
112
|
+
|
|
113
|
+
- [uv](https://docs.astral.sh/uv/getting-started/installation/) (gestiona Python y las dependencias).
|
|
114
|
+
- Un cliente compatible con servidores MCP locales por transporte STDIO.
|
|
115
|
+
|
|
116
|
+
### 1. Configurar credenciales
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
uvx unlam-mcp login
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
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.
|
|
123
|
+
|
|
124
|
+
Si la clave de MIeL cambia, se debe ejecutar `login` nuevamente. Para eliminar las credenciales almacenadas: `uvx unlam-mcp logout`.
|
|
125
|
+
|
|
126
|
+
### 2. Registrar el servidor en el cliente
|
|
127
|
+
|
|
128
|
+
En todos los clientes, el comando de inicio es `uvx unlam-mcp`.
|
|
129
|
+
|
|
130
|
+
<details>
|
|
131
|
+
<summary><b>Claude Code</b></summary>
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
claude mcp add unlam -- uvx unlam-mcp
|
|
135
|
+
```
|
|
136
|
+
</details>
|
|
137
|
+
|
|
138
|
+
<details>
|
|
139
|
+
<summary><b>Claude Desktop</b></summary>
|
|
140
|
+
|
|
141
|
+
En *Settings → Developer → Edit Config*, agregar:
|
|
142
|
+
|
|
143
|
+
```json
|
|
144
|
+
{
|
|
145
|
+
"mcpServers": {
|
|
146
|
+
"unlam": {
|
|
147
|
+
"command": "uvx",
|
|
148
|
+
"args": ["unlam-mcp"]
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
Reiniciar Claude Desktop para aplicar los cambios.
|
|
155
|
+
</details>
|
|
156
|
+
|
|
157
|
+
<details>
|
|
158
|
+
<summary><b>Cursor</b></summary>
|
|
159
|
+
|
|
160
|
+
En `~/.cursor/mcp.json` (o desde *Settings → MCP → Add new server*):
|
|
161
|
+
|
|
162
|
+
```json
|
|
163
|
+
{
|
|
164
|
+
"mcpServers": {
|
|
165
|
+
"unlam": {
|
|
166
|
+
"command": "uvx",
|
|
167
|
+
"args": ["unlam-mcp"]
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
```
|
|
172
|
+
</details>
|
|
173
|
+
|
|
174
|
+
<details>
|
|
175
|
+
<summary><b>VS Code (Copilot)</b></summary>
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
code --add-mcp "{\"name\":\"unlam\",\"command\":\"uvx\",\"args\":[\"unlam-mcp\"]}"
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
Alternativamente, en `.vscode/mcp.json` (o desde *MCP: Open User Configuration*):
|
|
182
|
+
|
|
183
|
+
```json
|
|
184
|
+
{
|
|
185
|
+
"servers": {
|
|
186
|
+
"unlam": {
|
|
187
|
+
"type": "stdio",
|
|
188
|
+
"command": "uvx",
|
|
189
|
+
"args": ["unlam-mcp"]
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
Las herramientas están disponibles en el chat en modo *Agent*.
|
|
196
|
+
</details>
|
|
197
|
+
|
|
198
|
+
<details>
|
|
199
|
+
<summary><b>Windsurf</b></summary>
|
|
200
|
+
|
|
201
|
+
En `~/.codeium/windsurf/mcp_config.json`:
|
|
202
|
+
|
|
203
|
+
```json
|
|
204
|
+
{
|
|
205
|
+
"mcpServers": {
|
|
206
|
+
"unlam": {
|
|
207
|
+
"command": "uvx",
|
|
208
|
+
"args": ["unlam-mcp"]
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
```
|
|
213
|
+
</details>
|
|
214
|
+
|
|
215
|
+
<details>
|
|
216
|
+
<summary><b>Codex (CLI y extensión)</b></summary>
|
|
217
|
+
|
|
218
|
+
```bash
|
|
219
|
+
codex mcp add unlam -- uvx unlam-mcp
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
Alternativamente, en `~/.codex/config.toml`:
|
|
223
|
+
|
|
224
|
+
```toml
|
|
225
|
+
[mcp_servers.unlam]
|
|
226
|
+
command = "uvx"
|
|
227
|
+
args = ["unlam-mcp"]
|
|
228
|
+
```
|
|
229
|
+
</details>
|
|
230
|
+
|
|
231
|
+
<details>
|
|
232
|
+
<summary><b>Gemini CLI</b></summary>
|
|
233
|
+
|
|
234
|
+
En `~/.gemini/settings.json`:
|
|
235
|
+
|
|
236
|
+
```json
|
|
237
|
+
{
|
|
238
|
+
"mcpServers": {
|
|
239
|
+
"unlam": {
|
|
240
|
+
"command": "uvx",
|
|
241
|
+
"args": ["unlam-mcp"]
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
```
|
|
246
|
+
</details>
|
|
247
|
+
|
|
248
|
+
<details>
|
|
249
|
+
<summary><b>Otros clientes (LM Studio, Cline, Zed, etc.)</b></summary>
|
|
250
|
+
|
|
251
|
+
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.
|
|
252
|
+
</details>
|
|
253
|
+
|
|
254
|
+
### Notas de compatibilidad
|
|
255
|
+
|
|
256
|
+
- **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.
|
|
257
|
+
- **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.
|
|
258
|
+
- **Contenido de imagen:** `miel_ver_pagina` devuelve imágenes. En clientes sin soporte para imágenes, el resto de las herramientas funciona con normalidad.
|
|
259
|
+
- **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`.
|
|
260
|
+
|
|
261
|
+
### Variables de entorno
|
|
262
|
+
|
|
263
|
+
| Variable | Valor por defecto | Descripción |
|
|
264
|
+
|---|---|---|
|
|
265
|
+
| `MIEL_CARPETA` | `~/MIeL` | Directorio de destino de las descargas. |
|
|
266
|
+
| `MIEL_USUARIO`, `MIEL_CLAVE` | Las credenciales de `login` | Credenciales alternativas, para entornos sin gestor de credenciales (por ejemplo, un servidor). |
|
|
267
|
+
|
|
268
|
+
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`).
|
|
269
|
+
|
|
270
|
+
## Desarrollo
|
|
271
|
+
|
|
272
|
+
### Estructura
|
|
273
|
+
|
|
274
|
+
```
|
|
275
|
+
src/unlam_mcp/
|
|
276
|
+
├── server.py # definición de las herramientas MCP
|
|
277
|
+
├── miel.py # cliente HTTP de MIeL: autenticación, páginas y descargas
|
|
278
|
+
├── parsers.py # parseo del HTML de MIeL a estructuras de datos
|
|
279
|
+
├── intraconsulta.py # cliente de la API JSON de Intraconsulta
|
|
280
|
+
└── archivos.py # extracción de texto de PDF, Word y PowerPoint, y renderizado de páginas
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
Para ejecutar desde el código fuente: clonar el repositorio y ejecutar `uv run unlam-mcp`.
|
|
284
|
+
|
|
285
|
+
### Arquitectura
|
|
286
|
+
|
|
287
|
+
**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.
|
|
288
|
+
|
|
289
|
+
**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.
|
|
290
|
+
|
|
291
|
+
### Agregar una herramienta
|
|
292
|
+
|
|
293
|
+
1. El parser de la página va en `parsers.py`.
|
|
294
|
+
2. El método que realiza la solicitud va en `MielClient` (`miel.py`).
|
|
295
|
+
3. La herramienta va en `server.py`, con el nombre `miel_<accion>`.
|
|
296
|
+
|
|
297
|
+
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.
|
|
298
|
+
|
|
299
|
+
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`.
|
|
300
|
+
|
|
301
|
+
## Hoja de ruta
|
|
302
|
+
|
|
303
|
+
- [ ] Intraconsulta: inscripción a materias y a mesas de final.
|
|
304
|
+
|
|
305
|
+
## Créditos
|
|
306
|
+
|
|
307
|
+
Basado en [TBalles/miel-mcp](https://github.com/TBalles/miel-mcp) y [nialvape/utn-mcp](https://github.com/nialvape/utn-mcp).
|
|
308
|
+
|
|
309
|
+
El uso de este servidor debe ser moderado y respetar el [aviso legal de MIeL](https://miel.unlam.edu.ar/principal/legal/).
|
|
310
|
+
|
|
311
|
+
## Licencia
|
|
312
|
+
|
|
313
|
+
MIT
|
|
314
|
+
|
|
315
|
+
<!-- mcp-name: io.github.blasestevez/unlam-mcp -->
|
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
# unlam-mcp
|
|
2
|
+
|
|
3
|
+
Servidor [MCP](https://modelcontextprotocol.io) (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.
|
|
4
|
+
|
|
5
|
+
Ejemplos de consultas:
|
|
6
|
+
|
|
7
|
+
- *"¿Qué contenidos se publicaron esta semana en Programación Avanzada?"*
|
|
8
|
+
- *"Descargá el programa de Base de Datos."*
|
|
9
|
+
- *"¿Qué respondió el docente en el foro del TP?"*
|
|
10
|
+
- *"¿Qué entregas tengo esta semana y qué notas me asignaron?"*
|
|
11
|
+
- *"¿Hay novedades en MIeL?"*
|
|
12
|
+
- *"Resumí el apunte de la unidad 3 de Redes."*
|
|
13
|
+
- *"¿Cuándo son los recuperatorios?"*
|
|
14
|
+
- *"¿Cuál es mi asistencia en Redes?"*
|
|
15
|
+
- *"Reservá el turno de las 18 h del recuperatorio."*
|
|
16
|
+
- *"Enviá un mensaje a mi grupo de Taller Web con el informe adjunto."*
|
|
17
|
+
- *"Entregá este PDF en el TP 1 de Base de Datos."*
|
|
18
|
+
- *"¿Cuál es mi promedio y cuántas materias tengo aprobadas?"*
|
|
19
|
+
|
|
20
|
+
> [!NOTE]
|
|
21
|
+
> Proyecto no oficial, sin relación con la UNLaM. La mayoría de las herramientas son de solo lectura. Las únicas operaciones de escritura son **reservar y cancelar turnos, enviar mensajes y entregar prácticas**, y se ejecutan únicamente a pedido del usuario. El foro y las evaluaciones son de solo lectura: el servidor no publica en el foro ni inicia evaluaciones.
|
|
22
|
+
|
|
23
|
+
## Herramientas
|
|
24
|
+
|
|
25
|
+
### Consulta (MIeL)
|
|
26
|
+
|
|
27
|
+
| Herramienta | Descripción |
|
|
28
|
+
|---|---|
|
|
29
|
+
| `miel_novedades` | Novedades de todas las materias: archivos nuevos, mensajes sin leer y foros con actividad. |
|
|
30
|
+
| `miel_materias` | Materias del usuario, con comisión y elementos pendientes. |
|
|
31
|
+
| `miel_calendario` | Parciales, recuperatorios, entregas y defensas de todas las materias, con fecha, lugar y horario. |
|
|
32
|
+
| `miel_contenidos` | Archivos y enlaces publicados por los docentes, con carpeta, fecha e indicador de novedad. |
|
|
33
|
+
| `miel_leer` | Extrae el texto de un apunte (PDF, Word, PowerPoint o texto plano) para su análisis. |
|
|
34
|
+
| `miel_ver_pagina` | Renderiza una página de un PDF como imagen, para documentos escaneados, gráficos o fórmulas. |
|
|
35
|
+
| `miel_descargar` | Descarga un archivo, o el adjunto de un mensaje, al equipo local. |
|
|
36
|
+
| `miel_foro` | Temas del foro de una materia, con cantidad de mensajes sin leer. |
|
|
37
|
+
| `miel_foro_tema` | Mensajes de un tema del foro. |
|
|
38
|
+
| `miel_mensajes` | Bandeja de mensajes de una materia: avisos y correcciones de los docentes. |
|
|
39
|
+
| `miel_mensaje` | Contenido completo de un mensaje, con sus adjuntos. |
|
|
40
|
+
| `miel_destinatarios` | Destinatarios disponibles en una materia: docentes, compañeros y grupo. |
|
|
41
|
+
| `miel_practicas` | Trabajos prácticos y parciales: vencimiento, estado de entrega, estado de corrección y nota. Por materia o para todas. |
|
|
42
|
+
| `miel_asistencia` | Asistencia por clase con resumen, y notas de las evaluaciones online. |
|
|
43
|
+
| `miel_grupos` | Grupos de trabajo de cada materia, con sus integrantes. |
|
|
44
|
+
| `miel_evaluaciones` | Evaluaciones online de una materia y su estado de habilitación. Solo las lista. |
|
|
45
|
+
| `miel_turnos` | Turnos de una materia (recuperatorios, consultas): fecha, lugar, vacantes y estado de la reserva. |
|
|
46
|
+
|
|
47
|
+
### Consulta (Intraconsulta)
|
|
48
|
+
|
|
49
|
+
Utiliza las mismas credenciales que MIeL (DNI y clave) para acceder a [Intraconsulta](https://intraconsulta.unlam.edu.ar):
|
|
50
|
+
|
|
51
|
+
| Herramienta | Descripción |
|
|
52
|
+
|---|---|
|
|
53
|
+
| `intraconsulta_materias_en_curso` | Materias inscriptas en el cuatrimestre actual: comisión, día y horario, aula y modalidad. |
|
|
54
|
+
| `intraconsulta_historia_academica` | Materias aprobadas con nota, fecha, acta y origen (promoción, examen o equivalencia), y el promedio simple calculado sobre ellas. |
|
|
55
|
+
| `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. |
|
|
56
|
+
| `intraconsulta_regularizadas` | Materias con cursada aprobada y examen final pendiente. |
|
|
57
|
+
| `intraconsulta_constancias` | Materias o mesas de final para las que hay constancia de examen disponible. |
|
|
58
|
+
| `intraconsulta_descargar_constancia` | Descarga la constancia de examen en PDF en `MIEL_CARPETA/Intraconsulta`. No tiene costo ni inicia ningún trámite. |
|
|
59
|
+
|
|
60
|
+
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.
|
|
61
|
+
|
|
62
|
+
### Operaciones de escritura
|
|
63
|
+
|
|
64
|
+
| Herramienta | Descripción |
|
|
65
|
+
|---|---|
|
|
66
|
+
| `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. |
|
|
67
|
+
| `miel_cancelar_turno` | Cancela un turno reservado y libera la vacante. |
|
|
68
|
+
| `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. |
|
|
69
|
+
| `miel_entregar_practica` | Entrega un trabajo práctico del portafolio mediante la carga de un archivo (máximo 40 MB). |
|
|
70
|
+
|
|
71
|
+
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.
|
|
72
|
+
|
|
73
|
+
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.
|
|
74
|
+
|
|
75
|
+
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.
|
|
76
|
+
|
|
77
|
+
## Instalación
|
|
78
|
+
|
|
79
|
+
### Requisitos
|
|
80
|
+
|
|
81
|
+
- [uv](https://docs.astral.sh/uv/getting-started/installation/) (gestiona Python y las dependencias).
|
|
82
|
+
- Un cliente compatible con servidores MCP locales por transporte STDIO.
|
|
83
|
+
|
|
84
|
+
### 1. Configurar credenciales
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
uvx unlam-mcp login
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
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.
|
|
91
|
+
|
|
92
|
+
Si la clave de MIeL cambia, se debe ejecutar `login` nuevamente. Para eliminar las credenciales almacenadas: `uvx unlam-mcp logout`.
|
|
93
|
+
|
|
94
|
+
### 2. Registrar el servidor en el cliente
|
|
95
|
+
|
|
96
|
+
En todos los clientes, el comando de inicio es `uvx unlam-mcp`.
|
|
97
|
+
|
|
98
|
+
<details>
|
|
99
|
+
<summary><b>Claude Code</b></summary>
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
claude mcp add unlam -- uvx unlam-mcp
|
|
103
|
+
```
|
|
104
|
+
</details>
|
|
105
|
+
|
|
106
|
+
<details>
|
|
107
|
+
<summary><b>Claude Desktop</b></summary>
|
|
108
|
+
|
|
109
|
+
En *Settings → Developer → Edit Config*, agregar:
|
|
110
|
+
|
|
111
|
+
```json
|
|
112
|
+
{
|
|
113
|
+
"mcpServers": {
|
|
114
|
+
"unlam": {
|
|
115
|
+
"command": "uvx",
|
|
116
|
+
"args": ["unlam-mcp"]
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
Reiniciar Claude Desktop para aplicar los cambios.
|
|
123
|
+
</details>
|
|
124
|
+
|
|
125
|
+
<details>
|
|
126
|
+
<summary><b>Cursor</b></summary>
|
|
127
|
+
|
|
128
|
+
En `~/.cursor/mcp.json` (o desde *Settings → MCP → Add new server*):
|
|
129
|
+
|
|
130
|
+
```json
|
|
131
|
+
{
|
|
132
|
+
"mcpServers": {
|
|
133
|
+
"unlam": {
|
|
134
|
+
"command": "uvx",
|
|
135
|
+
"args": ["unlam-mcp"]
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
```
|
|
140
|
+
</details>
|
|
141
|
+
|
|
142
|
+
<details>
|
|
143
|
+
<summary><b>VS Code (Copilot)</b></summary>
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
code --add-mcp "{\"name\":\"unlam\",\"command\":\"uvx\",\"args\":[\"unlam-mcp\"]}"
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
Alternativamente, en `.vscode/mcp.json` (o desde *MCP: Open User Configuration*):
|
|
150
|
+
|
|
151
|
+
```json
|
|
152
|
+
{
|
|
153
|
+
"servers": {
|
|
154
|
+
"unlam": {
|
|
155
|
+
"type": "stdio",
|
|
156
|
+
"command": "uvx",
|
|
157
|
+
"args": ["unlam-mcp"]
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
Las herramientas están disponibles en el chat en modo *Agent*.
|
|
164
|
+
</details>
|
|
165
|
+
|
|
166
|
+
<details>
|
|
167
|
+
<summary><b>Windsurf</b></summary>
|
|
168
|
+
|
|
169
|
+
En `~/.codeium/windsurf/mcp_config.json`:
|
|
170
|
+
|
|
171
|
+
```json
|
|
172
|
+
{
|
|
173
|
+
"mcpServers": {
|
|
174
|
+
"unlam": {
|
|
175
|
+
"command": "uvx",
|
|
176
|
+
"args": ["unlam-mcp"]
|
|
177
|
+
}
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
```
|
|
181
|
+
</details>
|
|
182
|
+
|
|
183
|
+
<details>
|
|
184
|
+
<summary><b>Codex (CLI y extensión)</b></summary>
|
|
185
|
+
|
|
186
|
+
```bash
|
|
187
|
+
codex mcp add unlam -- uvx unlam-mcp
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
Alternativamente, en `~/.codex/config.toml`:
|
|
191
|
+
|
|
192
|
+
```toml
|
|
193
|
+
[mcp_servers.unlam]
|
|
194
|
+
command = "uvx"
|
|
195
|
+
args = ["unlam-mcp"]
|
|
196
|
+
```
|
|
197
|
+
</details>
|
|
198
|
+
|
|
199
|
+
<details>
|
|
200
|
+
<summary><b>Gemini CLI</b></summary>
|
|
201
|
+
|
|
202
|
+
En `~/.gemini/settings.json`:
|
|
203
|
+
|
|
204
|
+
```json
|
|
205
|
+
{
|
|
206
|
+
"mcpServers": {
|
|
207
|
+
"unlam": {
|
|
208
|
+
"command": "uvx",
|
|
209
|
+
"args": ["unlam-mcp"]
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
```
|
|
214
|
+
</details>
|
|
215
|
+
|
|
216
|
+
<details>
|
|
217
|
+
<summary><b>Otros clientes (LM Studio, Cline, Zed, etc.)</b></summary>
|
|
218
|
+
|
|
219
|
+
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.
|
|
220
|
+
</details>
|
|
221
|
+
|
|
222
|
+
### Notas de compatibilidad
|
|
223
|
+
|
|
224
|
+
- **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.
|
|
225
|
+
- **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.
|
|
226
|
+
- **Contenido de imagen:** `miel_ver_pagina` devuelve imágenes. En clientes sin soporte para imágenes, el resto de las herramientas funciona con normalidad.
|
|
227
|
+
- **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`.
|
|
228
|
+
|
|
229
|
+
### Variables de entorno
|
|
230
|
+
|
|
231
|
+
| Variable | Valor por defecto | Descripción |
|
|
232
|
+
|---|---|---|
|
|
233
|
+
| `MIEL_CARPETA` | `~/MIeL` | Directorio de destino de las descargas. |
|
|
234
|
+
| `MIEL_USUARIO`, `MIEL_CLAVE` | Las credenciales de `login` | Credenciales alternativas, para entornos sin gestor de credenciales (por ejemplo, un servidor). |
|
|
235
|
+
|
|
236
|
+
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`).
|
|
237
|
+
|
|
238
|
+
## Desarrollo
|
|
239
|
+
|
|
240
|
+
### Estructura
|
|
241
|
+
|
|
242
|
+
```
|
|
243
|
+
src/unlam_mcp/
|
|
244
|
+
├── server.py # definición de las herramientas MCP
|
|
245
|
+
├── miel.py # cliente HTTP de MIeL: autenticación, páginas y descargas
|
|
246
|
+
├── parsers.py # parseo del HTML de MIeL a estructuras de datos
|
|
247
|
+
├── intraconsulta.py # cliente de la API JSON de Intraconsulta
|
|
248
|
+
└── archivos.py # extracción de texto de PDF, Word y PowerPoint, y renderizado de páginas
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
Para ejecutar desde el código fuente: clonar el repositorio y ejecutar `uv run unlam-mcp`.
|
|
252
|
+
|
|
253
|
+
### Arquitectura
|
|
254
|
+
|
|
255
|
+
**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.
|
|
256
|
+
|
|
257
|
+
**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.
|
|
258
|
+
|
|
259
|
+
### Agregar una herramienta
|
|
260
|
+
|
|
261
|
+
1. El parser de la página va en `parsers.py`.
|
|
262
|
+
2. El método que realiza la solicitud va en `MielClient` (`miel.py`).
|
|
263
|
+
3. La herramienta va en `server.py`, con el nombre `miel_<accion>`.
|
|
264
|
+
|
|
265
|
+
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.
|
|
266
|
+
|
|
267
|
+
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`.
|
|
268
|
+
|
|
269
|
+
## Hoja de ruta
|
|
270
|
+
|
|
271
|
+
- [ ] Intraconsulta: inscripción a materias y a mesas de final.
|
|
272
|
+
|
|
273
|
+
## Créditos
|
|
274
|
+
|
|
275
|
+
Basado en [TBalles/miel-mcp](https://github.com/TBalles/miel-mcp) y [nialvape/utn-mcp](https://github.com/nialvape/utn-mcp).
|
|
276
|
+
|
|
277
|
+
El uso de este servidor debe ser moderado y respetar el [aviso legal de MIeL](https://miel.unlam.edu.ar/principal/legal/).
|
|
278
|
+
|
|
279
|
+
## Licencia
|
|
280
|
+
|
|
281
|
+
MIT
|
|
282
|
+
|
|
283
|
+
<!-- mcp-name: io.github.blasestevez/unlam-mcp -->
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "unlam-mcp"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "Servidor MCP para la UNLaM: MIeL e Intraconsulta desde cualquier asistente con MCP (Claude, Cursor, VS Code, Codex, Gemini CLI...)."
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
license = "MIT"
|
|
7
|
+
license-files = ["LICENSE"]
|
|
8
|
+
requires-python = ">=3.12"
|
|
9
|
+
keywords = [
|
|
10
|
+
"mcp",
|
|
11
|
+
"mcp-server",
|
|
12
|
+
"model-context-protocol",
|
|
13
|
+
"unlam",
|
|
14
|
+
"miel",
|
|
15
|
+
"intraconsulta",
|
|
16
|
+
"universidad",
|
|
17
|
+
"argentina",
|
|
18
|
+
]
|
|
19
|
+
classifiers = [
|
|
20
|
+
"Development Status :: 4 - Beta",
|
|
21
|
+
"Environment :: Console",
|
|
22
|
+
"Intended Audience :: Education",
|
|
23
|
+
"Natural Language :: Spanish",
|
|
24
|
+
"Operating System :: OS Independent",
|
|
25
|
+
"Programming Language :: Python :: 3",
|
|
26
|
+
"Programming Language :: Python :: 3.12",
|
|
27
|
+
"Topic :: Education",
|
|
28
|
+
]
|
|
29
|
+
dependencies = [
|
|
30
|
+
"beautifulsoup4>=4.12",
|
|
31
|
+
"httpx>=0.28",
|
|
32
|
+
"keyring>=25.7.0",
|
|
33
|
+
"mcp>=2.3,<3",
|
|
34
|
+
"pillow>=13.0.0",
|
|
35
|
+
"pydantic-settings>=2.6",
|
|
36
|
+
"pypdfium2>=5.15.2",
|
|
37
|
+
"python-docx>=1.2.0",
|
|
38
|
+
"python-pptx>=1.0.2",
|
|
39
|
+
]
|
|
40
|
+
|
|
41
|
+
[[project.authors]]
|
|
42
|
+
name = "Blas"
|
|
43
|
+
email = "126523540+blasestevez@users.noreply.github.com"
|
|
44
|
+
|
|
45
|
+
[project.urls]
|
|
46
|
+
Homepage = "https://github.com/blasestevez/unlam-mcp"
|
|
47
|
+
Repository = "https://github.com/blasestevez/unlam-mcp"
|
|
48
|
+
Issues = "https://github.com/blasestevez/unlam-mcp/issues"
|
|
49
|
+
|
|
50
|
+
[project.scripts]
|
|
51
|
+
unlam-mcp = "unlam_mcp.server:main"
|
|
52
|
+
|
|
53
|
+
[build-system]
|
|
54
|
+
requires = ["uv_build>=0.13.8,<0.14.0"]
|
|
55
|
+
build-backend = "uv_build"
|