librus-mcp

Локальный MCP-сервер с доступом только для чтения для учётной записи Librus Portal. Он использует процедуру входа в Portal для получения кратковременного токена API Librus для выбранной учётной записи Synergia.

Модель безопасности

• Учётные данные считываются только из LIBRUS_EMAIL и LIBRUS_PASSWORD.

• Файлы cookie и токены хранятся в памяти и отбрасываются при завершении процесса или вызове librus_logout.

• Сервер разрешает HTTPS-запросы только к portal.librus.pl и api.librus.pl.

• Он предоставляет список разрешённых ресурсов API с доступом только для чтения; он не может отправлять сообщения, отмечать уведомления как прочитанные или отправлять произвольные запросы.

• Сервер намеренно не записывает в stdout/stderr ни запросы, ни ответы, ни учётные данные, ни токены, ни данные API. Stdout зарезервирован для трафика протокола MCP.

Не храните учётные данные в package.json, в конфигурации MCP, сохранённой в Git, или в отслеживаемом файле .env.

Related MCP server: moodle-utn-mcp

Установка и сборка

cd /home/xadix0wy/librus-mcp
npm install
npm run build

Настройка MCP-хоста

Используйте переменные окружения в приватной конфигурации хоста или в хранилище секретов:

{
  "mcpServers": {
    "librus": {
      "command": "node",
      "args": ["/home/xadix0wy/librus-mcp/dist/index.js"],
      "env": {
        "LIBRUS_EMAIL": "your-email@example.com",
        "LIBRUS_PASSWORD": "your-password"
      }
    }
  }
}

LIBRUS_CLIENT_ID необязателен. По умолчанию используется публичный клиентский идентификатор из устаревшего мобильного потока Librus. Он не считается секретом.

Инструменты

• librus_profiles: перечисляет учётные записи Synergia, привязанные к учётной записи Portal.

• librus_get: считывает оценки, посещаемость, расписание, домашние задания, уведомления, информацию о школе и другие поддерживаемые ресурсы API. Передавайте account_login из librus_profiles.

• librus_logout: очищает все данные аутентификации в памяти.

Portal может потребовать прохождения reCAPTCHA или выполнения действия с учётной записью. В этом случае сервер останавливается с понятной ошибкой; выполните требуемое действие напрямую на https://portal.librus.pl или в официальном приложении, а затем повторите попытку.

Совместимость

Это основано на недокументированном механизме Portal/API, замеченном в исходном коде устаревшего Android-приложения Szkolny. Librus может изменить или ограничить его без предупреждения. Он предназначен только для владельца учётной записи и должен использоваться в соответствии с условиями Librus и правилами школы.