Skip to main content
Glama

MIREA Lecture Assistant MCP

Отдельный необязательный MCP-сервер для настройки и диагностики Lecture Assistant. У сервера свои версии и релизы: текущая версия 0.2.0, протокол приложения 1. В Lecture Assistant нет встроенной нейронки или чата.

Установка на Windows

В Lecture Assistant 0.2.28+ откройте вкладку MCP, нажмите «Скачать и установить» и включите «Разрешить локальное MCP-подключение». Скопируйте конфигурацию в ИИ-клиент с поддержкой локального MCP/stdio. Python на пользовательском ПК не нужен. Клиент запускает McpLauncher.exe, который выбирает установленную текущую версию. При обновлении переподключите MCP в клиенте: существующий процесс не заменяется.

Приложение и MCP обновляются независимо. Обновление Lecture Assistant не трогает MCP: тот лежит в профиле (%LOCALAPPDATA%\MireaLectureAssistant\mcp). Обновление MCP не трогает приложение. Старые версии MCP приложение удаляет само, как только ИИ-клиент перестаёт их использовать. Новый McpLauncher.exe ставится, даже если старый сейчас запущен: старый переименовывается и удаляется позже. Временные папки %TEMP%\_MEI…, которые остаются, когда клиент закрывает MCP принудительно, приложение тоже удаляет (Lecture Assistant 0.2.29+). Для удаления старых версий нужен Lecture Assistant 0.2.28+.

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

Related MCP server: AxonHub MCP Server

Инструменты

Инструмент

Действие

get_status

Версия приложения, состояние сканера, разрешение изменений

get_settings

Несекретные настройки и схема допустимых значений

get_schedule

Уже загруженное расписание, без обращения к сайтам

get_subject_rules

Правила AUTO/ASK/IGNORE

update_settings

Изменить разрешённые настройки по просьбе пользователя

set_subject_rule

Настроить существующий предмет по просьбе пользователя

check_health

Работает ли приложение сейчас: вердикт, проблемы и что поможет; при сбое — проверка сети и VPN

wait_and_check

То же через 0–120 секунд, чтобы увидеть, помогла ли починка

repair

Починка: повторный вход, обновить расписание, переоткрыть комнату, перезапустить браузер или сканер. Нужно разрешение «чинить» в приложении

get_recent_problems

Последние ошибки журнала: только время и названия событий

get_attendance_history

Последние QR-события и отмеченные пары

get_vpn_help

Как пропустить МИРЭА мимо VPN, с готовыми файлами

report_fix

Отчёт о починке: приложение удаляет личные данные и отправляет его разработчику

Готовые инструкции (prompts): «Проверить и починить приложение» (duty_check) и «Дежурство на сегодняшних парах» (setup_lecture_watch). Вторая годится для клиента, который умеет отложенные задачи: он сам поставит проверки на +5 и +20 минут каждой пары. Проще включить «ИИ-дежурного» на вкладке MCP в приложении (0.2.32+). Тогда приложение само проверяет пары и зовёт Codex или Claude Code только при сбое.

Новые инструменты требуют Lecture Assistant 0.2.32+; старое приложение вежливо попросит обновиться. Нет инструментов для паролей, кодов входа, QR, отправки отметок/чатов, произвольного SQL, файлов или команд оболочки. Сервер не читает базу/журналы приложения и Диспетчер учётных данных. Наличие процесса не означает успешный захват.

Подключение и статусы

Приложение слушает только 127.0.0.1, с отдельным случайным ключом и новым портом на каждый запуск. Локальный файл mcp-connection.json содержит ключ подключения; его нельзя публиковать. В конфигурации ИИ-клиента ключей нет. Веб-источники и запросы без ключа отклоняются. HTTP-прокси для локальной связи не используется. После перезапуска приложения сервер перечитывает ключ и порт.

MCP-процесс поддерживает heartbeat. До первого вызова инструмента вкладка показывает «ожидает первого запроса ИИ», после вызова — «подключён». Отключённый процесс исчезает из статуса; при аварийном завершении — не позднее 35 секунд. Это не попытка угадать, какая модель/чат открыты на компьютере.

Разработка и релизы

python -m venv .venv
.venv/Scripts/python -m pip install -e . pytest pyinstaller
.venv/Scripts/python -m pytest
.venv/Scripts/python scripts/package.py

Сервер использует официальный Python SDK MCP (поддерживаемую линию 1.x). Не импортирует код Lecture Assistant. Расширять инструменты можно независимо, используя совместимый локальный API v1. Изменение самого API требует поддержки со стороны приложения, но добавление инструментов поверх имеющегося API — нет.

Релиз выпускается сам, когда в main меняется версия в src/mirea_assistant_mcp/__init__.py (и в pyproject.toml). Каждый релиз публикует Windows ZIP и .sha256. ZIP включает два exe, README и manifest с версией, протоколом и контрольными суммами exe, а также лицензию. Приложение проверяет источник, SHA-256, совместимость, размеры и состав архива; произвольные пути из архива не извлекаются. Предыдущая версия остаётся, пока её использует работающий клиент.

Лицензия

MIT. Это пользовательское ПО, не официальный сервис университета.

Available Tools

13 tools
check_healthA

Is the app working right now? Returns verdict "ok" or "problem", each problem with repair actions, the current pair, and a network check (MIREA sites, internet, VPN) when something is wrong. Call this first; if ok, nothing else is needed.

Inputs: no named parameters.

get_attendance_historyC

Recent QR events and the pairs where attendance was marked (no QR contents).

Inputs: no named parameters.

get_recent_problemsA

Latest warnings and errors of the app's log: time, level, module, event name only.

Inputs: no named parameters.

get_scheduleA

Read cached schedule, without refreshing websites or opening lectures.

Inputs: no named parameters.

get_settingsA

Read non-secret settings and their validation schema. No credentials or email codes.

Inputs: no named parameters.

get_statusA

Read application version and scanner state without logging in or submitting anything.

Inputs: no named parameters.

get_subject_rulesB

Read AUTO/ASK/IGNORE rules for subjects in the cached schedule.

Inputs: no named parameters.

get_vpn_helpA

How to let MIREA and MTS Link bypass the user's VPN, with ready files; also shows the instructions in the app. Use when check_health says vpn_suspected.

Inputs: no named parameters.

repairA

Start one repair from a problem's actions: retry_login, refresh_schedule, reopen_lecture, restart_browser or start_scanner. Needs the user's «Разрешить ИИ чинить приложение» permission in the app. Check the result with wait_and_check.

Inputs: action (required).

report_fixA

Finish a repair round: 3–6 lines in Russian on what was wrong, what you did and whether it helped. The app removes personal data and sends it to the developer.

Inputs: fixed (required), summary (required).

set_subject_ruleA

Set AUTO/ASK/IGNORE for an existing subject, only at user's request and with app-side permission. AUTO affects future lecture opening; never change attendance rules silently.

Inputs: mode (required), subject (required).

update_settingsA

Apply only settings listed by get_settings. Requires explicit app-side write permission and no unsaved UI edits. Ask the user first. Changes take effect in the running app.

Inputs: settings (required).

wait_and_checkC

Wait 0–120 seconds (a repair takes a minute or so), then check_health again.

Inputs: seconds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools target clearly distinct actions: health check, repair lifecycle, logs, schedule, settings, attendance, and subject rules. Some boundaries are naturally close—check_health, get_status, and get_recent_problems all relate to app health—but descriptions distinguish their scope well.

    Naming Consistency4/5

    The set mostly follows a predictable snake_case verb_noun pattern: get_*, set_*, update_*, check_health, wait_and_check, report_fix. There are minor deviations like the single verb 'repair' and the compound 'wait_and_check', but the convention remains readable and consistent overall.

    Tool Count5/5

    With 13 tools, the server is well-scoped for a lecture assistant covering diagnostics, repair, settings, schedule, attendance, and subject rules. Each tool appears to earn its place without obvious redundancy or bloat.

    Completeness4/5

    The surface covers the important lifecycle: health check, repair initiation, waiting, reporting, logs, VPN help, schedule/settings/status reads, and subject-rule read/write. Minor gaps remain—e.g., no deletion or listing of all subject rules separately—but core workflows are well supported.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI clients to perform safe, read-only IT diagnostics and retrieve local runbooks, asset records, and knowledge articles through MCP, with allowlisted network checks and audit logging.
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Enables AI clients to query AxonHub admin data through natural language, including instance status, projects, channels, models, requests, and usage statistics, with read-only safeguards and sensitive-field redaction.
      8
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to query an Action1 RMM tenant for organizations, endpoints, groups, missing updates, vulnerabilities, automations, reports, users, and roles, and to build custom PowerShell-based reports whose results can be requeryed and read back. It also runs one-off PowerShell diagnostics as SYSTEM on selected Windows endpoints and allows limited report-related changes, while leaving endpoints, users, and organizations untouched.
      33
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Gives AI clients read-first access to Windows processes, services, startup apps, disk usage, GPU/CPU/memory stats, and allowlisted read-only PowerShell commands without any screen or cursor control. State-changing actions such as starting or killing processes are gated behind an explicit confirmation flag.
      MIT