HSE RUZ

Name: HSE RUZ
Author: ihavealotofguap

本地服务

github.com/ihavealotofguap生产力14 天前更新

代码仓库

关于 HSE RUZ

HSE RUZ 是一个本地 MCP 服务，可通过 HSE University 的 RUZ API 搜索人员、群组和教室，并查询学生或群组课表。它需要接入学校网络，无需登录凭据。

主要功能

01搜索学生、教师、群组和教室
02按邮箱查询学生课表
03按 RUZ ID 查询群组课表
04查询未来 1 至 60 天的课表

适用场景

01查找群组并查看一周课表
02检查学生近期课表

MCP 相关

通过本地 STDIO MCP 服务提供三个工具：人员搜索、学生课表查询和群组课表查询。RUZ API 只能从 HSE 内部网络或员工 VPN 访问。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ihavealotofguap-hse-ruz": {
      "command": "npx",
      "args": [
        "-y",
        "hse-ruz-mcp"
      ]
    }
  }
}

启动命令npx -y hse-ruz-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmhse-ruz-mcp0.2.3stdio

工具

收录的工具列表 · 更新于 4 天前

参数	类型	必填	说明
term	string	是	搜索字符串：姓名的一部分、组号等。
type	enum	否	student \| lecturer \| group \| auditorium
limit	integer	否	Сколько совпадений вернуть

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

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 (`[email protected]`) на 1–60 дней вперёд (по умолчанию 7)
`ruz_get_group_schedule`	Возвращает расписание группы по RUZ id (id берётся из `ruz_find_person` с `type=group`) на 1–60 дней вперёд (по умолчанию 7)

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

Примеры запросов

«Какие у меня пары завтра? Мой email [email protected]»
«Найди группу БПИ231 и покажи её расписание на неделю»

Разработка

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

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