# VSUET Timetable API и MCP

Клиентская библиотека и MCP-сервер для получения расписания ВГУИТ с сайта `timetable.vsuet.ru`.

Библиотека `vsuet` отвечает за HTTP-запросы, разбор HTML и нормализацию расписания. `mcp_server.py` предоставляет эти возможности через MCP-инструменты.

## Возможности

- расписание групп, преподавателей и аудиторий;
- списки групп, преподавателей и аудиторий;
- фильтры по неделе, дню и типу занятия;
- JSON- и текстовый вывод;
- прямые обращения к API через `VsuetClient`.

## Запуск

```bash
uv venv .venv
uv pip install --python .venv/Scripts/python.exe -r requirements.txt
.venv/Scripts/python.exe mcp_server.py
```

Для Linux используйте `.venv/bin/python`.

## Инструменты

- `vsuet_list_groups(contains="")`
- `vsuet_list_teachers(contains="")`
- `vsuet_list_rooms(contains="")`
- `vsuet_find_teacher(name)`
- `vsuet_lesson_types()`
- `vsuet_get_schedule(value, kind, week, weekday, lesson_type, output)`
- `vsuet_get_group_schedule(group, ...)`
- `vsuet_get_teacher_schedule(teacher, ...)`
- `vsuet_get_room_schedule(room, ...)`
- `vsuet_today(value, kind, week, output)`

`kind`: `group`, `teacher` или `room`.

`output`: `json` или `text`.