English Français العربية

HSE RUZ

Registre officiel Recherche et web

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que HSE RUZ ?

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

Comment installer HSE RUZ ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add hse-ruz -- npx -y hse-ruz-mcp@0.2.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour HSE RUZ ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

HSE RUZ est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient HSE RUZ ?

Il est publié par ihavealotofguap. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.