mcp-guap

mcp-guap

MCP-сервер для личного кабинета ГУАП (pro.guap.ru). Позволяет ИИ-агентам (Claude и другим) работать с заданиями, материалами и отчётами студента.

Что умеет

MCP Mode (для ИИ-ассистентов)

| Инструмент | Описание | |---|---| | authenticate | 🔐 Авторизация через браузер (открывает окно, ждёт входа, сохраняет cookies) | | check_auth_status | Проверить, валидны ли сохранённые cookies | | list_tasks | Список всех заданий текущего семестра (дедлайны, баллы, статусы) | | get_task | Детали задания: описание, доп. материалы, сданные отчёты | | list_materials | Учебные материалы семестра (файлы и внешние ссылки) | | download_material | Скачать учебный материал (с pro.guap.ru, Google Drive или любой ссылке) | | submit_report | Загрузить файл отчёта к заданию | | get_my_profile | Профиль студента: ФИО, группа, номер зачётки | | get_teacher_info | Информация о преподавателе | | get_subject_info | Информация о дисциплине | | get_my_group_order | Порядковый номер в группе |

CLI Mode (автономный терминал)

| Команда | Описание | |---|---| | guap pro auth | 🔐 Авторизация через браузер | | guap pro check | Проверить авторизацию | | guap pro tasks | Список заданий с фильтрами | | guap pro task <id> | Детали задания | | guap pro materials | Учебные материалы | | guap pro profile | Профиль студента | | guap skill | Установить Agent Skill в agents/skills/ |

Требования

• uv — менеджер пакетов Python
• Claude Desktop (или любой другой MCP-клиент)
• Аккаунт ГУАП на pro.guap.ru

Установка

Клонировать репозиторий не нужно — достаточно uv.

Вариант 1: Автоматическая авторизация (рекомендуется)

1. Установить Playwright browsers

При первом запуске автоматической авторизации, Claude установит необходимые браузеры автоматически. Это может занять 1-2 минуты.

Или установите вручную: ``bash uvx playwright install chromium ``

2. Добавить сервер в Claude Desktop

Откройте файл конфигурации Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Добавьте секцию mcpServers:

{
  "mcpServers": {
    "guap": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ehlvg/mcp-guap", "mcp-guap"]
    }
  }
}

2. Перезапустить Claude Desktop

3. Выполнить авторизацию

Просто скажите Claude: > "Выполни авторизацию в ГУАП"

Claude откроет браузер, вам нужно будет ввести логин и пароль. Cookies сохранятся автоматически.

Вариант 2: Ручная настройка (без браузера)

Если не хотите использовать автоматическую авторизацию:

1. Войдите в pro.guap.ru в браузере
2. Откройте DevTools → вкладка Network
3. Обновите страницу, кликните на любой запрос к pro.guap.ru
4. В заголовках запроса найдите Cookie и скопируйте всё значение
5. Добавьте в конфигурацию Claude Desktop:

{
  "mcpServers": {
    "guap": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ehlvg/mcp-guap", "mcp-guap"],
      "env": {
        "GUAP_COOKIE": "YOUR_COOKIE_STRING_HERE"
      }
    }
  }
}

Куки живут несколько часов. Когда перестанет работать — выполните authenticate снова или обновите GUAP_COOKIE.

Вариант 3: Agent Skill (для AI-агентов с поддержкой Agent Skills)

Если ваш AI-агент поддерживает Agent Skills:

# Установить skill в agents/skills/
uvx --from git+https://github.com/ehlvg/mcp-guap guap skill

# Или в кастомную директорию
uvx --from git+https://github.com/ehlvg/mcp-guap guap skill --path ./my-agents/skills

Skill будет автоматически обнаружен агентом. Просто спросите: > "Помоги мне с заданиями в ГУАП"

Вариант 4: CLI режим (терминал)

Если предпочитаете работать в терминале:

# Использование
uvx --from git+https://github.com/ehlvg/mcp-guap guap pro auth
guap pro tasks
guap pro task 181395
guap pro materials
guap pro profile

Форматы вывода

Поддерживаются форматы table (по умолчанию), json и csv:

# JSON формат
guap pro tasks --format json
guap pro profile --format json
guap pro task 181395 --format json

# CSV формат
guap pro tasks --format csv > tasks.csv
guap pro materials --format csv > materials.csv

Использование

MCP режим

Просто общайтесь с Claude на естественном языке:

«Покажи все мои задания» «Что нужно сдать по вычислительной математике?» «Загрузи файл ~/Documents/report.pdf как отчёт к заданию 181395»

Запуск вручную (для отладки)

GUAP_COOKIE="..." uvx --from git+https://github.com/ehlvg/mcp-guap mcp-guap

Структура проекта

mcp-guap/
├── mcp_guap/
│   ├── server.py        # MCP-сервер
│   ├── cli.py           # CLI инструмент (guap)
│   ├── auth.py          # Авторизация через браузер
│   ├── guap_client.py   # HTTP-клиент
│   └── skill/           # Agent Skill (agentskills.io)
│       ├── SKILL.md     # Skill metadata + instructions
│       ├── scripts/     # Helper scripts
│       └── references/  # Documentation
├── pyproject.toml       # Зависимости проекта
└── cookie.json          # Cookies (автосоздается)