# Dnevnik.ru MCP Server

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

## Возможности

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

## Установка

```bash
# Клонировать репозиторий
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`:

```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](https://github.com/kesha1225/DnevnikRuAPI) - Python библиотека
- [pydnevnikruapi-extended](https://github.com/yasg1988/pydnevnikruapi-extended) - расширенная версия