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)

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

Расписание

Оценки

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

Класс и школа

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

Примеры использования в 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 - расширенная версия