Skip to content
tab11pmPublic

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

41 Commits

Folders and files

Repository files navigation

SDO TUSUR MCP Server

Локальный MCP-сервер для SDO ТУСУР. Через Playwright он входит в SDO, читает курсы и задания, скачивает материалы одного модуля и находит активность онлайн-лекции BigBlueButton (BBB). Сервер работает через stdio.

Установка и запуск

npm install
npm run build
node dist/index.js

Для MCP-клиента укажите команду node с аргументом, содержащим абсолютный путь к dist/index.js. Сообщения протокола идут через stdout, диагностические сообщения — через stderr.

Использование как зависимость

Добавьте в package.json приложения зависимость от выпущенного тега:

"sdo_mcp": "github:tab11pm/sdo-mcp#v1.2.0"

При установке из git npm собирает TypeScript через prepare; точка входа находится в node_modules/sdo_mcp/dist/index.js. Запускайте её как процесс MCP по stdio:

node node_modules/sdo_mcp/dist/index.js

SDO_BROWSER_CHANNEL=msedge заставляет Playwright использовать установленный Microsoft Edge. Если переменная не задана или содержит только пробелы, используется Chromium Playwright; установите его командой npx playwright install chromium. Ошибка запуска браузера возвращается инструменту с подсказкой по выбранному каналу.

Инструменты

sdo_login

Выполняет вход через SSO кабинета ТУСУРа и сохраняет сессию Playwright в SDO_AUTH_STATE_PATH. Аргументы не нужны. Успешный ответ: {"status":"logged_in"}.

check_sdo_auth

Проверяет, действует ли сохранённая сессия. Аргументы не нужны. Ответ: {"authenticated":true} или {"authenticated":false}.

resolve_online_lecture

Ищет BBB-активность в курсе, используя сохранённую сессию. Передайте ровно один из courseUrl и courseQuery; необязательный lectureQuery уточняет название лекции.

{
	"courseQuery": "физика",
	"lectureQuery": "лекция 1"
}

Ответ имеет статус resolved, ambiguous, not_found или auth_required. При resolved возвращаются курс и модуль со стабильным URL активности BBB. При нескольких совпадениях ambiguous содержит кандидатов. Временные ссылки входа в комнату не возвращаются. Этот инструмент сам не выполняет вход: сначала вызовите sdo_login, если сессии нет или она истекла.

Инструменты курсов

Все инструменты ниже используют сохранённую сессию. Если она истекла, сначала вызовите sdo_login.

  • list_courses — список доступных курсов; аргументов нет.
  • list_course_modules — материалы и задания одного курса; аргумент courseUrl.
  • find_course_module — поиск материала или задания в одном курсе; аргументы courseUrl и query.
  • get_assignment_details — текст одного задания; аргумент assignmentUrl.
  • download_module_files — скачивание файлов одного ресурса или задания; аргумент moduleUrl. Результат сохраняется в downloads/.

Адреса модулей должны вести на HTTPS sdo.tusur.ru и содержать только числовой id. Ссылки на другие сайты и переходы за пределы SDO блокируются. Скачиваются ссылки pluginfile.php и прямые ссылки на файлы с известными расширениями на самом SDO: не более 20 файлов, 25 МиБ на файл и 100 МиБ суммарно за вызов. Ссылки с произвольными параметрами запроса не используются. Имя файла берётся из Content-Disposition, когда сервер его передаёт, и очищается перед сохранением.

Переменные окружения

Переменная Назначение
SDO_USERNAME Логин кабинета ТУСУРа для sdo_login.
SDO_PASSWORD Пароль кабинета ТУСУРа для sdo_login.
SDO_AUTH_STATE_PATH Путь к файлу состояния сессии; по умолчанию storage/auth.json. Лучше задавать абсолютный путь.
HEADLESS При значении true запускает браузер без окна; при других значениях открывает окно.
SDO_BROWSER_CHANNEL Канал установленного браузера, например msedge; без значения используется Chromium Playwright.
SDO_DEBUG_SCREENSHOTS Только при значении 1 сохраняет отладочные снимки страниц входа в рабочую папку. Снимки могут содержать данные входа.

Файл состояния сессии и отладочные снимки содержат чувствительные данные. Храните их локально и не добавляйте в Git.

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

Инструменты курсов, удалённые в версии 1.2.0, восстановлены под прежними именами и с прежними аргументами. Ответы содержат прежние основные поля; теперь небезопасные адреса и неавторизованные запросы отклоняются.

Разработка

npx tsc --noEmit
npm test
npm run build

Для ручной проверки входа, поиска и скачивания доступны команды:

npx tsx src/test-login.ts
npx tsx src/test-find-module.ts "https://sdo.tusur.ru/course/view.php?id=123" "название"
npx tsx src/test-download.ts "https://sdo.tusur.ru/mod/resource/view.php?id=456"

Они используют сохранённую сессию или выполняют вход по настройкам окружения. Скачанные файлы сохраняются в downloads/.

About

No description, website, or topics provided.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages