English Français العربية

HSE RUZ

Official registry Search and web

HSE University (NIU VShE) RUZ timetable: search people, groups, rooms; get schedules

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package hse-ruz-mcp
Claude Code 
claude mcp add hse-ruz -- npx -y hse-ruz-mcp@0.2.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hse-ruz": {
            "command": "npx",
            "args": [
                "-y",
                "hse-ruz-mcp@0.2.3"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. hse-ruz-mcp
  2. Ограничение: только из сети ВШЭ
  3. Установка
  4. Tools
  5. Разработка
  6. Лицензия

hse-ruz-mcp

Локальный MCP-сервер (stdio) для расписания НИУ ВШЭ через API RUZ (ruz.hse.ru/api): ищет студентов, преподавателей, группы и аудитории, показывает расписание студента по email и расписание группы. Логин, пароль и браузер не нужны.

Ограничение: только из сети ВШЭ

RUZ отвечает только из внутренней сети ВШЭ (Wi-Fi HSE.Student на кампусе или VPN сотрудника). Вне её API перенаправляет на HTML-заглушку, и tools возвращают ошибку с объяснением.

Установка

Нужен Node.js 22+.

Claude Code
claude mcp add hse-ruz-mcp -- npx -y hse-ruz-mcp
Claude Desktop, Cursor и другие клиенты
{
  "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.js

Tools

ToolЧто делает
ruz_find_personИщет студента, преподавателя, группу или аудиторию по подстроке и возвращает id (type: student по умолчанию, lecturer, group, auditorium)
ruz_get_my_scheduleВозвращает расписание студента по корпоративному email (login@edu.hse.ru) на 1–60 дней вперёд (по умолчанию 7)
ruz_get_group_scheduleВозвращает расписание группы по RUZ id (id берётся из ruz_find_person с type=group) на 1–60 дней вперёд (по умолчанию 7)

По преподавателям и аудиториям есть только поиск, расписание по ним сервер не отдаёт. Даты запроса берутся в часовом поясе машины (ожидается московское время).

Примеры запросов
  • «Какие у меня пары завтра? Мой email login@edu.hse.ru»
  • «Найди группу БПИ231 и покажи её расписание на неделю»

Разработка

  • npm run build собирает проект в dist/, npm run dev собирает в режиме watch.
  • npm test собирает проект и запускает тесты node:test (test/*.test.mjs, fetch подменён, сеть не нужна).

Участие в разработке и выпуск релизов описаны в CONTRIBUTING.md.

Лицензия

MIT

Frequently asked questions

What is HSE RUZ?

HSE University (NIU VShE) RUZ timetable: search people, groups, rooms; get schedules

How do I install HSE RUZ?

It runs on your machine. In Claude Code: claude mcp add hse-ruz -- npx -y hse-ruz-mcp@0.2.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does HSE RUZ need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is HSE RUZ open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains HSE RUZ?

It is published by ihavealotofguap. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.