Dnevnik.ru MCP Server

MCP (Model Context Protocol) сервер для работы с API Дневник.ру. Позволяет ИИ-ассистентам (Claude, etc.) получать расписание, оценки, домашние задания.

Возможности

• 📅 Расписание уроков на любой период
• 📊 Оценки ученика (текущие и итоговые)
• 📝 Домашние задания
• 👥 Информация о классе, учителях, одноклассниках
• 🏫 Данные о школе (для администраторов)
• ✅ Посещаемость уроков

Установка

# Клонировать репозиторий
git clone https://github.com/yasg1988/dnevnik-mcp-server.git
cd dnevnik-mcp-server

# Установить зависимости
pip install -r requirements.txt

# Создать конфигурацию
cp config.example.json config.json
# Отредактировать config.json - добавить токен

Получение токена

1. Авторизоваться на https://login.dnevnik.ru/login
2. Перейти по ссылке:

   https://login.dnevnik.ru/oauth2?response_type=token&client_id=b8006d75-70a9-4291-885c-13d8511bb2ae&scope=CommonInfo,EducationalInfo
   

3. Нажать "Разрешить"
4. Скопировать токен из URL после access_token=

Настройка Claude Desktop

Добавить в claude_desktop_config.json:

{
  "mcpServers": {
    "dnevnik": {
      "command": "python",
      "args": ["C:/path/to/dnevnik-mcp-server/server.py"],
      "env": {
        "DNEVNIK_TOKEN": "ваш_токен",
        "DNEVNIK_PERSON_ID": "1234567890",
        "DNEVNIK_SCHOOL_ID": "1234567890",
        "DNEVNIK_GROUP_ID": "1234567890"
      }
    }
  }
}

Или использовать config.json (сервер автоматически его прочитает).

Доступные инструменты (Tools)

Информация о пользователе

Tool	Описание
get_user_info	Информация о текущем пользователе
get_context	Контекст пользователя (школы, классы)

Расписание

Tool	Описание
get_schedule	Расписание ученика на период
get_schedule_today	Расписание на сегодня
get_schedule_week	Расписание на неделю

Оценки

Tool	Описание
get_marks	Оценки за период
get_marks_recent	Последние оценки (7 дней)
get_final_marks	Итоговые оценки
get_average_marks	Средние оценки по предметам

Домашние задания

Tool	Описание
get_homework	Домашние задания на период
get_homework_week	ДЗ на текущую неделю

Класс и школа

Tool	Описание
get_classmates	Одноклассники
get_teachers	Учителя класса
get_subjects	Предметы класса
get_school_groups	Все классы школы (для админов)

Посещаемость

Tool	Описание
get_attendance	Посещаемость за период
set_attendance	Отметить посещаемость (для учителей)

Примеры использования в Claude

Пользователь: Покажи расписание на завтра

Claude: [использует get_schedule_today]
Вот расписание на завтра:
1. 08:30 — Математика (каб. 205)
2. 09:20 — Русский язык (каб. 301)
...

Пользователь: Какие оценки получил за последнюю неделю?

Claude: [использует get_marks_recent]
За последнюю неделю получены оценки:
- Математика: 5, 4
- Русский язык: 5
...

Лицензия

MIT

Связанные проекты

• pydnevnikruapi - Python библиотека
• pydnevnikruapi-extended - расширенная версия