Skip to main content
Glama

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/

Related MCP server: qldt-hanu-mcp

Требования

  • uv — менеджер пакетов Python

  • Claude Desktop (или любой другой MCP-клиент)

  • Аккаунт ГУАП на pro.guap.ru

Установка

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

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

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

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

Или установите вручную:

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 (автосоздается)

Available Tools

11 tools
authenticateA

Authenticate with GUAP via browser automation. Opens a browser window, navigates to pro.guap.ru login page, waits for you to enter credentials, and saves session cookies. The cookies are saved to a file and will be used automatically for subsequent requests. Timeout is 120 seconds by default.

Inputs: timeout.

check_auth_statusA

Check if current authentication cookies are valid. Returns whether cookies are valid and can access the GUAP profile.

Inputs: no named parameters.

download_materialA

Download a material file by URL. Works for three kinds of URLs: (1) pro.guap.ru internal links — authenticated automatically via the session cookie; (2) Google Drive share links (drive.google.com/file/d/...) — handles the confirmation page; (3) any other direct download URL (PDF, ZIP, etc.). The file is saved to ~/Downloads/guap-materials/ by default. Returns the local file path, filename, size in bytes, and content type.

Inputs: url (required), save_dir.

get_my_group_orderA

Get the current student's order number (порядковый номер) in the group list. Also returns the total number of students in the group, the student's full name, and the group name.

Inputs: no named parameters.

get_my_profileA

Get the current student's profile: full name (ФИО), group, student book number, institute, specialty, study form, education level, and enrollment status.

Inputs: no named parameters.

get_subject_infoA

Get detailed information about a specific subject/discipline by its numeric ID. Returns name, department (кафедра), year and semester, control type (экзамен/зачёт/КП etc.), current grade, total hours, and the assigned teacher with their position. Subject IDs are available in list_tasks, get_task, and list_materials results.

Inputs: subject_id (required).

get_taskA

Get full details for a specific task by its numeric ID. Includes: description, allowed file extensions for the report, extra materials links, deadline, and the list of already submitted reports with their statuses.

Inputs: task_id (required).

get_teacher_infoA

Get information about a teacher by their numeric profile ID. Returns full name (ФИО), academic degree/rank, and list of positions (each with position title, department, and organization). Teacher IDs are available in list_tasks, get_task, and list_materials results.

Inputs: teacher_id (required).

list_materialsA

List learning materials available to the student. Each material has a name, discipline, date added, teacher, and either a download URL (for files hosted on pro.guap.ru) or an external URL (Google Drive, etc.). All filters are optional and default to the current semester. semester: numeric semester ID (e.g. 27 = '2025/2026 весенний'). subject_id: numeric discipline ID to show materials for one subject only.

Inputs: semester, subject_id. Returns: result

list_tasksA

List tasks assigned to the student. Returns task id, discipline, name, status, points (earned/max), type, deadline, and teacher. All filters are optional and default to showing everything for the current semester. semester: numeric semester ID (e.g. 27 = '2025/2026 весенний'). subject_id: numeric discipline ID to show tasks for one subject only. task_type: 0=все, 1=Курсовой проект, 2=Лабораторная работа, 3=Реферат, 4=Контрольная работа, 5=Расчетно-графическая работа, 6=Расчетное задание, 7=Эссе, 8=Отчет о практике, 9=Проверочная работа, 10=Индив. задание по ин. яз., 11=Текущее тестирование, 12=Научный доклад, 13=Отчет о науч. исслед., 14=Индивидуальное задание, 15=Практические задания, 16=Работа на занятии. show_status: 0=все, 1=только без отчета, 2=ожидающие проверки, 3=только принятые, 4=только непринятые, 5=все кроме принятых.

Inputs: semester, task_type, subject_id, show_status. Returns: result

submit_reportA

Submit a report file for a specific task. The file must already exist on the local filesystem. Allowed extensions depend on the task — check get_task first. An optional comment can be included with the submission.

Inputs: task_id (required), file_path (required), comment.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action: profile, teacher, subject, group order, task list, task detail, material list, authentication, download, submission, and auth check. Even related tools like get_my_profile and get_my_group_order are clearly separated by their specific purposes, with no overlap.

    Naming Consistency5/5

    All tool names follow the verb_noun pattern with snake_case (get_, list_, download_, submit_, check_, authenticate). The verbs are consistently used: 'list' for collections, 'get' for single items, and action verbs for operations. This provides a predictable and coherent naming scheme.

    Tool Count5/5

    With 11 tools, the set is well-scoped for a student portal. Each tool covers a necessary operation for managing tasks, materials, and submissions, without unnecessary duplication or bloat. The count falls squarely in the ideal range for a focused MCP server.

    Completeness5/5

    The tool surface covers the full student workflow: authentication, viewing profile, listing and viewing tasks, listing and downloading materials, submitting reports, and checking auth status. While minor gaps like a logout or listing all subjects exist, they are not essential for the core purpose and can be worked around. The lifecycle is complete for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that integrates with the Dnevnik.ru API to provide AI assistants with access to school schedules, grades, and homework. It enables users to query educational data and manage school-related information through natural language.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the QLDT HANU student management system, enabling AI assistants to authenticate and interact with the Hanoi University portal.
      1
      GPL 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that connects AI assistants to university D2L Brightspace and Piazza, enabling query of courses, grades, assignments, deadlines, files, and Piazza posts.
      7
      MIT