mcpField
H
HSE RUZ

HSE RUZ

ローカル
github.com/ihavealotofguap生産性14 日前に更新
リポジトリ

HSE RUZ について

HSE RUZ は、HSE University の RUZ API を使って人物・グループ・教室を検索し、学生またはグループの時間割を取得するローカル MCP サーバーです。大学ネットワークへの接続が必要で、ログイン情報は不要です。

主な機能

  1. 01学生、講師、グループ、教室の検索
  2. 02メールアドレスによる学生時間割の取得
  3. 03RUZ ID によるグループ時間割の取得
  4. 04今後1～60日分の時間割検索

活用シーン

  1. 01グループを探して1週間の時間割を確認
  2. 02学生の近日の時間割を確認

MCP 対応

ローカル STDIO MCP サーバーを通じて、人物検索、学生時間割検索、グループ時間割検索の3つのツールを公開します。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.3

ツール

3

掲載時のツール一覧 · 4 日前に更新

パラメーター型必須説明
termstringはい検索文字列：氏名の一部、グループ番号など。
typeenumいいえstudent | lecturer | group | auditorium
limitintegerいいえСколько совпадений вернуть

README（原文）English

プロジェクトの README より

この README の日本語訳はまだありません。以下は英語の原文です。日本語の紹介はページ上部をご覧ください。

hse-ruz-mcp

CI npm License: MIT

Локальный 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.

Лицензия

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。