RohanMuppa/brightspace-mcp-server

Скачивает конкретный файл из сданной в Dropbox работы студента (или группы) в локальный каталог, для преподавателя или TA. Сначала нужно вызвать get_dropbox_submissions или get_dropbox_user_submissions, чтобы найти submissionId и fileId. Требует доступа преподавателя или TA к курсу. ВАЖНО: Перед вызовом этого инструмента нужно спросить пользователя, куда сохранить файл. После того как файл найден, нужно предложить понятное читаемое имя и спросить, не хотят ли они его переименовать.

Скачивает файл из содержимого курса, файлов, привязанных по пути внутри описания модуля (coursePath, из quickLink-URL get_course_content с type=coursefile), вложений преподавателя к заданиям (source: assignmentAttachment с folderId + fileId), отправленных решений заданий или вложений объявления. Используйте этот инструмент, когда пользователю нужен файл из содержимого курса Brightspace, отправленных решений в dropbox или объявления (newsId + fileId, из get_announcements). Два режима ответа: (1) INLINE (по умолчанию - опустите downloadPath): файл возвращается прямо в ответе инструмента - извлечённый текст для PDF и документов Office, блок изображения для jpeg/png/gif/webp или краткое описание для всего остального, так что его можно прочитать сразу, не трогая файловую систему. Это правильный выбор в таких клиентах, как Claude Desktop, чьи инструменты анализа/песочницы не видят файл, который MCP-сервер записывает в свою файловую систему хоста. (2) DISK (задайте downloadPath как абсолютный путь в файловой системе ХОСТА, где работает MCP-сервер): файл сохраняется туда. Спросите пользователя, куда сохранить файл, прежде чем использовать режим DISK - никогда не угадывайте каталог. Определив файл, предложите понятное читаемое имя (например, 'Lecture 7 - Memory Management.pdf' вместо 'L07_CS251_2026SP_v2.pdf') и передайте его как customFilename, или опустите его, чтобы сохранить оригинальное имя. Если скачивание темы содержимого не удаётся, потому что файл ещё не выпущен, ответ объясняет причину, когда метаданные модуля/темы Brightspace это поддерживают (ещё не открыт, завершён, заблокирован или скрыт).

Читает файлы, которые преподаватель прикрепил к объявлению: вопросы для обсуждения, рубрику, обновлённое расписание, слайды. Вызывайте его только с courseId, чтобы увидеть, в каких объявлениях есть вложения, затем с newsId и fileId, чтобы прочитать одно из них. Используйте это, когда пользователь спрашивает, что говорит файл, прикреплённый к объявлению. Возвращает сам текст. Вместо этого используйте download_file (newsId + fileId), когда пользователь хочет сохранить файл на диск.

Получает объявления из одного курса по courseId или из всех курсов, если параметр опущен, сначала новые. count от 1 до 50 на страницу. Каждый body - полный текст объявления в markdown (ссылки сохраняются); pagination.truncated означает только то, что остались ещё объявления, и никогда - что body обрезан. Продолжайте с offset= pagination.nextOffset, пока он не станет null. Метаданные пагинации лежат в отдельном текстовом блоке JSON для ответов-массивов или в поле pagination вместе с modifiedSince. coverageComplete = false означает, что часть курсов не была получена: повторите запрос с offset 0 после восстановления. Смещения отражают текущий отфильтрованный список; новые записи могут сдвигать страницы. Вложения перечисляются для каждого объявления; скачивайте их через download_file (newsId + fileId) или читайте через get_announcement_files.

Читает файлы, которые преподаватель прикрепил к заданию: PDF со спецификацией или инструкциями, стартовый воркбук, документ с рубрикой оценивания. Вызовите его только с courseId, чтобы увидеть, у каких заданий есть вложения, затем с folderId и fileId, чтобы прочитать одно из них. Используйте его, когда пользователь спрашивает, что требуется в задании, что говорится в инструкциях, или просит кратко изложить раздаточный материал. Возвращает сам текст. Вместо этого используйте download_file, когда пользователь хочет сохранить файл на диск.

Получает полную рубрику оценивания для задания Dropbox: каждую группу критериев, критерий и уровень достижения с его баллами и описанием, а также собственный результат оценивания студента по каждому критерию, как только его опубликуют. Инструмент нужен, когда пользователь спрашивает, что требует рубрика, как будут оценивать задание или почему он получил конкретный балл по критерию.

Получает задания и тесты для конкретного курса или всех курсов, на которые записан пользователь. Показывает работы, отправленные в dropbox, и тесты с датами сдачи, статусом и информацией о критериях оценки. Используйте этот инструмент, когда пользователь спрашивает о заданиях, домашней работе, что нужно сдать, тестах или деталях заданий и критериях оценки. Читайте submissionStatus/attemptStatus, а не только submission/attemptsUsed, чтобы понять, сдана ли работа: некоторые tenants закрывают студентам доступ к данным о сдаче или попытках, и тогда статус будет "unknown", даже если submission равен null или attemptsUsed равен 0. Никогда не сообщайте об элементе со статусом "unknown" как о пропущенном, несданном или невыполненном - скажите, что проверить не удалось, и направьте пользователя в Brightspace. Тесты берутся из списка тестов, содержимого курса и журнала оценок; каждая строка теста указывает источник в поле source. Тест с id null найден только как тема содержимого. Строка теста с detailsStatus "unavailable" отображалась в содержимом курса, но Brightspace не вернул её детали (возможно, тест закрыт, ещё не открыт или доступен только некоторым студентам), поэтому даты и попытки могут отсутствовать: направьте пользователя по её ссылке. availability (notYetOpen, open, closed) вычисляется из собственных дат начала и окончания теста и опускается, если их нет. exempt: true означает, что Brightspace отметил пользователя как освобождённого от темы этого теста; тест всё равно попадает в список. Каждый курс также содержит quizCoverage. "complete" означает, что ответили все источники тестов, а не то, что все тесты гарантированно попадут в список; "incomplete" означает, что какой-то источник тестов прочитать не удалось, поэтому в курсе могут быть тесты, не попавшие в список. Никогда не делайте вывод, что тест пропущен или не пройден, только потому что его нет в списке, и никогда не подавайте перечисленные тесты как полный список. Строка gradeOnly с названием, похожим на тест, - это тест, детали которого прочитать не удалось.

Получает события календаря курса (экзамены, промежуточные экзамены, лабораторные, семинары, обзорные занятия, изменения расписания и дедлайны, которые преподаватели вносили прямо в календарь) по всем вашим курсам или одному курсу в заданном временном окне (по умолчанию следующие 7 дней). Используйте этот инструмент, когда пользователь спрашивает, когда экзамен, что у него в календаре или что происходит на этой неделе.

Получите все адреса электронной почты для всех участников курса: преподавателей, ассистентов и студентов. Используйте это, когда пользователь хочет получить список адресов для группы, отправить письмо всей группе или получить контактную информацию для всех записанных.

Получает дерево содержимого курса с модулями, темами, файлами и ссылками. Используйте его, когда пользователь спрашивает о материалах курса, слайдах лекций, загруженных файлах, структуре содержимого или о том, что находится в модуле курса. Используйте moduleTitle, чтобы отфильтровать конкретный модуль (например, 'Labs', 'Staff', 'Homeworks'), а не получать всё дерево целиком. Используйте maxDepth, чтобы ограничить глубину рекурсии для просмотра в виде оглавления. Модуль или тема, которые сейчас недоступны, содержат isAvailable/availabilityStatus/availabilityMessage (и startDate/endDate, когда они известны), которые объясняют, почему; если этих полей нет, значит, они доступны сейчас.

Получает содержимое доски обсуждений для курса, включая форумы, темы и сообщения. Используйте его, когда пользователь спрашивает о досках обсуждений, сообщениях на форуме, обсуждениях в классе или хочет посмотреть, что было опубликовано. Передайте только courseId, чтобы получить список всех форумов и их тем. Добавьте forumId, чтобы получить темы и сообщения для конкретного форума. Добавьте и forumId, и topicId, чтобы получить все сообщения в конкретной теме обсуждения.

Получает сохранённый отзыв для папки dropbox: оценку, состояние проверки, текст отзыва и подробности оценки по рубрике. Студенты: пропустите entityType и entityId, чтобы прочитать СВОЙ опубликованный отзыв по заданию (он не скрыт; используйте это, когда get_assignments показывает, что отзыв недоступен). Преподаватели и ассистенты: передайте entityType и entityId, чтобы прочитать то, что уже сохранено для любого пользователя или группы, например перед подготовкой нового отзыва; для чтения чужого отзыва нужен доступ преподавателя или ассистента к курсу.

Выводит список всех папок заданий/dropbox курса для преподавателя или TA. Возвращает ID папки, название, срок сдачи, даты начала и окончания, тип отправки, видимость и то, прикреплены ли рубрики. Используйте этот инструмент, чтобы узнать значения folderId перед вызовом get_dropbox_submissions, get_dropbox_user_submissions, get_dropbox_feedback или get_rubrics_for_object. Этот инструмент читает тот же список папок, который использует клиент самого студента, поэтому он не ограничен учётными записями преподавателя/TA, в отличие от get_dropbox_submissions, get_dropbox_feedback и download_dropbox_submission_file.

Выводит список всех работ, сданных каждым студентом (или группой) в папку dropbox, для преподавателя или TA: имена отправителей, даты сдачи, статус опоздания, списки файлов и статус обратной связи/оценки. Сначала использует get_dropbox_folders, чтобы найти folderId. Требует доступа преподавателя или TA; аккаунт студента получает понятное примечание вместо данных (собственные download_file / get_assignments студента уже покрывают его собственную сдачу). Результаты ограничены параметром limit (по умолчанию 100, максимум 1000); усечённый ответ сообщает об этом и запрашивает обратную связь только для возвращённой части.

Получает все работы, отправленные одним конкретным студентом (или группой) в папке dropbox, для преподавателя или TA - полезно для проверки работы одного студента перед подготовкой обратной связи. Сначала используйте get_dropbox_submissions или get_roster, чтобы найти userId. Требуется доступ преподавателя или TA к курсу.

Получает ваши курсы Brightspace, на которые вы записаны, с названиями, кодами и идентификаторами. Используйте этот инструмент, когда пользователь спрашивает о своих курсах, записанных классах, о том, что он проходит в этом семестре, или когда ему нужен идентификатор курса для других запросов.

Получает разбивку оценок для конкретного курса или всех курсов, на которые записан пользователь. Показывает элементы оценок с баллами, процентами и комментариями. Используйте этот инструмент, когда пользователь спрашивает об оценках, баллах, отметках, среднем балле, академической успеваемости или о том, как у него успехи на курсе.

Перечисляет проектные/дискуссионные группы текущего пользователя в курсе вместе с участниками каждой группы. Используйте, когда студент спрашивает, кто входит в его проектную группу, лабораторную группу или дискуссионную группу.

Получает список участников курса, включая преподавателей, ассистентов и, при необходимости, студентов с их именами, электронными адресами и ролями. Используйте этот инструмент, когда пользователь спрашивает об однокурсниках, контактах преподавателя, электронных адресах ассистентов, именах профессоров или о том, кто входит в группу. По умолчанию возвращает только преподавателей и ассистентов для конфиденциальности. Используйте параметр includeStudents, чтобы получить полный список группы.

Получает полную таблицу рубрики (критерии, уровни и баллы), прикреплённую к папке dropbox, для преподавателя или ассистента (TA). Сначала нужно вызвать get_dropbox_folders, чтобы найти folderId. Как и get_dropbox_folders, этот инструмент читает встроенные данные рубрики из листинга папки, поэтому доступ к нему не ограничен аккаунтами преподавателя/TA, в отличие от get_dropbox_submissions и get_dropbox_feedback.

Сообщает, какая версия Brightspace MCP server запущена, среду выполнения Node.js, платформу, путь к файлу конфигурации, каталог состояния сессии, настроенный URL школы, сохранены ли учётные данные, локальный часовой пояс сервера и смещение UTC, (если вход в браузере сохранён) что запомнил Microsoft: stay-signed-in и флажок Don't ask again MFA, (при входе) uniqueName/displayName аккаунта как signedInAs, и счётчики запросов этого процесса (запросы: ответы по классам статуса, сетевые ошибки, попадания/промахи кэша, coalesced joins и обновления токенов). Применяется для устранения неполадок, когда пользователь спрашивает, какая у него версия, или относительно какого часового пояса/дат аккаунта ведутся вычисления. Никогда не связывается с Brightspace и никогда не возвращает секреты.

Получает текст программы курса/обзора и необязательное вложение для курса. Возвращает описание обзора курса в формате Markdown. Когда программа курса находится во внешнем инструменте LTI (например, Simple Syllabus), перечисляет эти источники в externalSyllabusSources; их содержимое прочитать нельзя. Если какие-то из этих запросов не удалось выполнить (например, доступ запрещён), externalSyllabusDiscovery указывает, какие именно, и пустой результат тогда не доказывает, что у курса нет программы. Если указан downloadPath, дополнительно скачивает вложение с программой курса (например, PDF). ВАЖНО: Вы ОБЯЗАНЫ спросить пользователя, куда он хочет сохранить файл, прежде чем вызывать этот инструмент с downloadPath.

Получает предстоящие сроки сдачи по всем вашим курсам, вычисляемые из сроков сдачи заданий (папок Dropbox), тестов и самих оцениваемых тем обсуждений, а также событий календаря курса, таких как экзамены и лабораторные работы (тип: event). Используйте это, когда пользователь спрашивает о дедлайнах, что нужно сдать, предстоящей работе или что им нужно сделать на этой неделе.

Читает расшифровку видео, встроенного в содержимое курса, например записанной лекции или поясняющего ролика. Вызывайте его с courseId и topicId из get_course_content (typeFilter: 'video' или 'other') или напрямую с videoUrl, если ссылка уже есть. Возвращает текст расшифровки с временными метками, а также название и длительность, когда они доступны. Сейчас поддерживает Kaltura (например, BoilerCast, включая его ссылки Brightspace LTI) и YouTube; другие платформы возвращают понятное сообщение с указанием того, что пока не поддерживается. Каждый вызов возвращает не более maxChars символов (до 100000); чтобы прочитать всю расшифровку, вызывайте снова с offset, установленным в возвращённый nextOffset, пока truncated не станет false. Только для чтения: этот инструмент никогда не отмечает видео как просмотренное.

Ищет по ключевому слову в содержимом курса (модули, темы, имена файлов), объявлениях и форумах/темах обсуждений за один вызов, вместо чтения всего дерева содержимого. Используйте этот инструмент, когда пользователь хочет найти что-то конкретное, например «найди слайды к промежуточному экзамену» или «кто-нибудь писал про консультации». Результаты ранжируются: совпадение по всем словам запроса стоит выше совпадения лишь по части слов, а внутри этой группы совпадение в заголовке стоит выше совпадения только в тексте. Если какой-то источник (например, обсуждения) прочитать не удаётся, его пропускают и указывают в note, а не роняют весь поиск. Инструмент проходит по всему дереву содержимого, объявлениям и каждому форуму обсуждений, поэтому работает медленнее, чем прямой вызов одного инструмента вроде get_course_content.

Выполняет выход из Brightspace на этом компьютере: удаляет сохранённую сессию Brightspace, поэтому каждое приложение Brightspace на этом компьютере должно снова войти с нуля при следующем вопросе. Оставляет сохранённый пароль, настройки и ключ аутентификатора. Не выполняет выход из Microsoft или Brightspace на других устройствах. Вызывайте этот инструмент ТОЛЬКО когда пользователь явно просит выйти или разлогиниться из Brightspace (общий компьютер, передача машины другому). Никогда не вызывайте его для исправления ошибки, никогда в рамках ответа на другой вопрос и никогда, чтобы повторить или обновить вход.