Локальный 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.jsSDO_BROWSER_CHANNEL=msedge заставляет Playwright использовать установленный Microsoft
Edge. Если переменная не задана или содержит только пробелы, используется Chromium
Playwright; установите его командой npx playwright install chromium. Ошибка запуска
браузера возвращается инструменту с подсказкой по выбранному каналу.
Выполняет вход через SSO кабинета ТУСУРа и сохраняет сессию Playwright в SDO_AUTH_STATE_PATH. Аргументы не нужны. Успешный ответ: {"status":"logged_in"}.
Проверяет, действует ли сохранённая сессия. Аргументы не нужны. Ответ: {"authenticated":true} или {"authenticated":false}.
Ищет 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/.