English Français العربية

HSE RUZ

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو HSE RUZ؟

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

كيف أثبّت HSE RUZ؟

يعمل على جهازك. في Claude Code: claude mcp add hse-ruz -- npx -y hse-ruz-mcp@0.2.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج HSE RUZ إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل HSE RUZ مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون HSE RUZ؟

ينشره ihavealotofguap. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.