A local stdio MCP server for the HSE University timetable (RUZ API) that looks up people/groups/rooms and returns their class schedules — no login, but only reachable from the HSE network.
ruz_find_person — search students (default), lecturers, groups or auditoriums by substring (min 2 chars), returning up to limit (default 20, max 100) matches with id/label plus total count.
ruz_get_schedule — fetch the schedule for a student, lecturer, group or auditorium by RUZ id (same type), for a date range.
ruz_get_my_schedule — fetch a student's own schedule from their @edu.hse.ru corporate email.
Period controls on every schedule tool: startDate (YYYY-MM-DD, MSK, past allowed, default today) and daysAhead (1–60, default 7).
language option (ru default / en) for discipline and room names.
Results come back as { from, to, lessons } (my-schedule also includes student), with read-only, cached (5 min) and 15-second-timeout behavior.
Requires campus Wi-Fi HSE.Student or staff VPN; outside the HSE network calls return an explanatory error.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@hse-ruz-mcp show my schedule for the next 7 days, my HSE email is i.petrov@edu.hse.ru"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
English. A local (stdio) MCP server for the HSE University timetable (RUZ,
ruz.hse.ru/api). It finds students, lecturers, groups and rooms (ruz_find_person) and returns their schedules (ruz_get_schedule, orruz_get_my_scheduleby a student's@edu.hse.ruemail). No login needed, but RUZ only answers from inside the HSE network (campus Wi-FiHSE.Studentor staff VPN). Install for Claude Code:claude mcp add hse-ruz-mcp -- npx -y hse-ruz-mcp(Node.js 22+).
Локальный MCP-сервер (stdio) для расписания НИУ ВШЭ через API RUZ (ruz.hse.ru/api): ищет
студентов, преподавателей, группы и аудитории и показывает их расписание (студента — в том числе по email).
Логин, пароль и браузер не нужны.
RUZ отвечает только из внутренней сети ВШЭ (Wi-Fi HSE.Student на кампусе или VPN сотрудника). Вне
её API перенаправляет на HTML-заглушку, и tools возвращают ошибку с объяснением.
Related MCP server: hdu-ics-mcp-server
Нужен Node.js 22+.
claude mcp add hse-ruz-mcp -- npx -y hse-ruz-mcp{
"mcpServers": {
"hse-ruz-mcp": {
"command": "npx",
"args": ["-y", "hse-ruz-mcp"]
}
}
}git clone https://github.com/ihavealotofguap/hse-ruz-mcp.git
cd hse-ruz-mcp
npm install
npm run build
claude mcp add hse-ruz-mcp -- node <путь-к-проекту>/dist/index.jsTool | Что делает |
| Ищет студента, преподавателя, группу или аудиторию по подстроке (от 2 символов) и возвращает до |
| Возвращает расписание студента, преподавателя, группы или аудитории по RUZ id из |
| Возвращает расписание студента по корпоративному email ( |
Параметры периода у всех тулов расписания:
startDate — первый день, ГГГГ-ММ-ДД (можно в прошлом), по умолчанию сегодня;
daysAhead — сколько дней, 1–60, по умолчанию 7;
language — язык названий дисциплин и аудиторий: ru (по умолчанию) или en.
Расписание возвращается как { from, to, lessons }, где from и to — фактические даты периода.
Все тулы только читают данные (аннотация readOnlyHint) и описывают формат ответа в outputSchema.
Даты считаются по московскому времени при любой часовой зоне машины. Запрос к RUZ прерывается через 15 секунд или когда клиент отменяет вызов. Успешные ответы RUZ кэшируются в памяти на 5 минут, а одинаковые запросы, отправленные одновременно, уходят в RUZ один раз.
«Какие у меня пары завтра? Мой email login@edu.hse.ru»
«Найди группу БПИ231 и покажи её расписание на неделю»
«Какие пары у преподавателя Иванова на следующей неделе с понедельника?»
npm run build собирает проект в dist/, npm run dev собирает в режиме watch.
npm run lint проверяет код линтером и форматтером Biome, npm run format исправляет то, что можно исправить автоматически.
npm test собирает проект и запускает тесты node:test (test/*.test.mjs, fetch подменён, сеть не нужна).
Участие в разработке и выпуск релизов описаны в CONTRIBUTING.md.
Поиск студента, преподавателя, группы или аудитории ВШЭ по подстроке (ФИО, номер группы) через API RUZ (ruz.hse.ru/api/search). ВАЖНО: RUZ отдаёт данные только из внутренней сети ВШЭ (Wi-Fi HSE.Student на кампусе или VPN сотрудника) — вне сети запрос вернёт ошибку. Возвращает до limit совпадений (id и подпись) и их общее число total — id с тем же type передаётся в ruz_get_schedule. Если total больше limit, уточните запрос.
Inputs: term (required), type, limit. Returns: total, results
Расписание занятий студента ВШЭ по его корпоративному email (login@edu.hse.ru) на daysAhead дней начиная со startDate (по умолчанию с сегодня). Использует API RUZ, который отдаёт данные только из внутренней сети ВШЭ (Wi-Fi HSE.Student на кампусе или VPN) — вне сети запрос вернёт ошибку.
Inputs: email (required), language, daysAhead, startDate. Returns: to, from, lessons, student
Расписание студента, преподавателя, группы или аудитории ВШЭ по RUZ id (узнать id — ruz_find_person с тем же type) на daysAhead дней начиная со startDate (по умолчанию с сегодня).
Inputs: id (required), type (required), language, daysAhead, +1 more. Returns: to, from, lessons
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 3 tools
The search tool and schedule tools are clearly distinct: one resolves names to RUZ ids, the other fetches schedules. The only overlap is between ruz_get_schedule and ruz_get_my_schedule, both returning schedules, but the descriptions clarify that one works by RUZ id for any entity and the other by corporate email for the current student.
All tools use the same ruz_ prefix and snake_case verb_noun pattern: ruz_find_person, ruz_get_schedule, ruz_get_my_schedule. The naming is predictable and readable.
Three tools are well-scoped for a focused RUZ schedule lookup server: search, schedule by id, and schedule by email. Each tool has a clear role and there is no unnecessary surface area.
The core workflow is covered: find a person/group/room, then fetch its schedule, plus a shortcut for the current student's schedule by email. Minor gaps exist, such as no explicit tool for enumerating supported entity types or additional schedule metadata, but agents can work around this through search.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Read Schedule it events, resources, groups and labels; create and update events and resources.
