mos-diary-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🎓 mos-diary-cli
mos-diary-cli — полнофункциональный модульный Python-клиент, консольный интерфейс (CLI), интерактивный TUI-дашборд и сервер (REST API + MCP) для экосистемы «Московской электронной школы» (МЭШ / school.mos.ru).
Единый универсальный шлюз к школьным данным: от расписания и домашних заданий до оценок, рейтингов, меню столовой, проходов через турникеты («Москвёнок»), олимпиад и портфолио. К сожалению, только read-only для данных.
Возможности проекта
Сервис | Описание | Основные эндпоинты |
1. Расписание | Расписание уроков, кабинеты, темы занятий, сетка звонков и учебные периоды/каникулы. |
|
2. Задания | Домашние задания со статусами сдачи, прикреплёнными файлами и материалами ЦДЗ. |
|
3. Оценки | Текущие оценки с весами и формами контроля, итоговые/годовые оценки, рейтинг по классу и предметам. |
|
4. Учёба | Учебный план с преподавателями, подготовка к ЕГЭ/ОГЭ, задолженности, Soft Skills, мерч МЭШ. |
|
5. Школа | Карточка школы, кружки и секции, фиксация проходов («Москвёнок»), баланс лицевого счёта и меню. |
|
6. Олимпиады | Всероссийская и Московская олимпиады, этапы (Школьный, Муниципальный и др.), статусы участия. |
|
7. Портфолио | Творчество, культура (посещения музеев), результаты независимых диагностик МЦКО и ГИА. |
|
Related MCP server: tbank-edu-mcp
🖥️ Сценарии использования
Человек в терминале (TUI / CLI):
Быстрый просмотр уроков, ДЗ или оценок одной командой в bash/zsh.
Полноэкранный интерактивный терминальный интерфейс (TUI) на библиотеке Textual с навигацией по датам и вкладкам.
AI-ассистенты (Model Context Protocol / MCP):
Прямое подключение к Claude Desktop, Cursor, Continue или любому LLM-агенту через стандартный ввод/вывод (
stdio).
Локальный микросервис (REST API + OpenAPI):
Полноценный сервер FastAPI с автодокументацией Swagger UI для интеграций (виджеты, Telegram-боты, умный дом).
📁 Структура проекта
mos-diary-cli/
├── auth/
│ ├── session_manager.py # Управление сессией: JWT decode, session.json, авторефреш
│ └── playwright_auth.py # Веб-авторизация (Playwright) с защитой от KFP антифрода
├── services/
│ ├── base.py # Базовый HTTP-клиент с управлением сессиями и заголовками
│ ├── schedule.py # 1. Расписание уроков, звонки, каникулы
│ ├── tasks.py # 2. Домашние задания и проектная деятельность
│ ├── marks.py # 3. Текущие/итоговые оценки и рейтинги
│ ├── study.py # 4. Учебный план, учителя, ЕГЭ/ОГЭ, навыки, награды
│ ├── school.py # 5. Профиль школы, кружки, турникеты («Москвёнок»), еда
│ ├── olympiads.py # 6. Олимпиады и конкурсы
│ └── portfolio.py # 7. Достижения, культура, ГИА, МЦКО
├── tests/
│ ├── conftest.py # Изоляция session.json и тестовые фикстуры
│ ├── test_auth.py # Тесты JWT, session_manager и рефреша
│ ├── test_services.py # Тесты доменных сервисов МЭШ и сетевых моков
│ ├── test_api_endpoints.py # Тесты REST API эндпоинтов FastAPI
│ └── test_cli.py # Тесты CLI команд Click
├── models.py # Единый реестр Pydantic v2 моделей данных
├── mosdiary_cli.py # Клиент: Click CLI + Textual TUI дашборд
├── mosdiary_server.py # Сервер: FastAPI REST API (--http) / MCP Server (по умолчанию)
├── session.json # Локальная сессия авторизации (создаётся автоматически)
└── requirements.txt # Зависимости проекта🛠️ Установка и настройка
1. Клонирование и зависимости
git clone https://github.com/your-username/mos-diary-cli.git
cd mos-diary-cli
python3 -m venv .venv
source .venv/bin/activate # На Windows: .venv\Scripts\activate
pip install -r requirements.txt
playwright install chromium2. Авторизация
Доступно два варианта входа:
Вариант А: Интерактивно через браузер (рекомендуется):
python mosdiary_cli.py loginОткроется окно браузера с официальным шлюзом авторизации МЭШ / СУДИР. Войдите по логину/паролю или через Госуслуги. Клиент автоматически перехватит токен, заполнит profile_id и сохранит конфигурацию в session.json.
Вариант Б: Прямой ввод токена:
python mosdiary_cli.py login --token "eyJhbGciOiJSUzI1NiIs..."Клиент автоматически декодирует идентификатор ученика, обратится к профилю МЭШ и сохранит сессию.
Сброс сессии:
python mosdiary_cli.py logout💻 Использование
1. Интерактивный TUI-дашборд
Запуск визуального терминального интерфейса:
python mosdiary_cli.py
# или
python mosdiary_cli.py tuiГорячие клавиши:
+/-— переход к следующему / предыдущему дню;t— возврат на сегодняшний день;r— принудительное обновление данных;q— выход из дашборда;Мышь/Tab— переключение между 7 вкладками.
2. Консольные команды (CLI)
# 1. Расписание уроков на сегодня
python mosdiary_cli.py schedule
# Расписание на 3 дня вперёд
python mosdiary_cli.py schedule --days 3
# 2. Домашние задания на ближайшие 14 дней
python mosdiary_cli.py tasks --days 14
# 3. Оценки за последние 30 дней и рейтинг
python mosdiary_cli.py marks --days 30
# 4. Учебный план и преподаватели
python mosdiary_cli.py study
# 5. Профиль школы, кружки и баланс карты «Москвёнок»
python mosdiary_cli.py school
# 6. Олимпиады и конкурсы
python mosdiary_cli.py olympiads
# 7. Достижения и портфолио
python mosdiary_cli.py portfolio3. REST API Сервер (FastAPI + Swagger UI)
Запуск локального сервера:
python mosdiary_server.py --http --host 127.0.0.1 --port 8000Swagger UI документация: http://127.0.0.1:8000/docs
OpenAPI схема: http://127.0.0.1:8000/openapi.json
Примеры запросов (curl):
# Авторизация/смена токена через REST
curl -X POST http://127.0.0.1:8000/api/auth/token \
-H "Content-Type: application/json" \
-d '{"token": "eyJhbGciOiJSUz..."}'
# Получить расписание уроков
curl http://127.0.0.1:8000/api/schedule
# Баланс питания «Москвёнок»
curl http://127.0.0.1:8000/api/school/food/balance4. Подключение к AI через MCP (Model Context Protocol)
Для подключения к Claude Desktop, Cursor или Continue, добавьте конфигурацию в ваш mcpServers:
{
"mcpServers": {
"mosdiary": {
"command": "python",
"args": [
"/абсолютный/путь/к/mos-diary-cli/mosdiary_server.py"
]
}
}
}LLM-ассистент получит доступ к инструментам:
mes_auth_token— авторизация/смена активного Bearer токена;mes_get_schedule— расписание уроков и сетка звонков;mes_get_homeworks— список домашних заданий с материалами;mes_get_projects— активные проектные работы;mes_get_marks— текущие оценки и формы контроля;mes_get_ranks— рейтинг учащегося по классу и предметам;mes_get_study_overview— контрольные работы, долги, Soft Skills и награды;mes_get_school_overview— профиль школы, кружки, баланс питания и проходы через турникет;mes_get_olympiads— олимпиады и этапы участия;mes_get_portfolio— культурные мероприятия, независимые диагностики и экзамены.
🧪 Тестирование
Запуск полного набора изолированных модульных тестов:
pytest tests/ -vВсе 21 тест выполняются оффлайн благодаря httpx.MockTransport и не требуют активного подключения к серверам МЭШ, да и вообще с ним не взаимодействует.
Перспективы (Roadmap)
Асинхронная неблокирующая подгрузка данных в TUI.
Поддержка многопрофильности (переключение между несколькими детьми для роли родителя).
Экспорт расписания уроков в календари (
.ics/ Google Calendar / Apple Calendar).
📄 Лицензия и отказ от ответственности
Проект распространяется под лицензией MIT.
Отказ от ответственности: Данный программный комплекс является неофициальным инструментом и разрабатывается исключительно в образовательных и исследовательских целях. Все права на товарные знаки и сервисы «МЭШ» и «Московская электронная школа» принадлежат их законным правообладателям (Правительство Москвы / ДИТ Москвы).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Automate 1,000+ services from any MCP-compatible AI agent: build Applets, run actions and queries.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to access Canvas LMS academic data such as courses, assignments, grades, and events via MCP tools.-
- FlicenseNot gradedqualityDmaintenanceMCP server that connects AI assistants to T-Bank Education, enabling access to courses, timetable, deadlines, and user profile via tools like get_timetable, get_my_courses, and get_deadlines.-
- FlicenseCqualityCmaintenanceEnables interaction with the Edookit school management system API, exposing attendance, lessons, people, grades, payments, courses, timetable, and individual goals as MCP tools.46-
- FlicenseNot gradedqualityCmaintenanceEnables AI clients to access and query WebUntis school data, including timetables, homework, exams, absences, and more via MCP tools.-