mcp-guap
Allows downloading educational materials from Google Drive links.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-guap show me my assignments for this semester"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-guap
MCP-сервер для личного кабинета ГУАП (pro.guap.ru). Позволяет ИИ-агентам (Claude и другим) работать с заданиями, материалами и отчётами студента.
Что умеет
MCP Mode (для ИИ-ассистентов)
Инструмент | Описание |
| 🔐 Авторизация через браузер (открывает окно, ждёт входа, сохраняет cookies) |
| Проверить, валидны ли сохранённые cookies |
| Список всех заданий текущего семестра (дедлайны, баллы, статусы) |
| Детали задания: описание, доп. материалы, сданные отчёты |
| Учебные материалы семестра (файлы и внешние ссылки) |
| Скачать учебный материал (с pro.guap.ru, Google Drive или любой ссылке) |
| Загрузить файл отчёта к заданию |
| Профиль студента: ФИО, группа, номер зачётки |
| Информация о преподавателе |
| Информация о дисциплине |
| Порядковый номер в группе |
CLI Mode (автономный терминал)
Команда | Описание |
| 🔐 Авторизация через браузер |
| Проверить авторизацию |
| Список заданий с фильтрами |
| Детали задания |
| Учебные материалы |
| Профиль студента |
| Установить Agent Skill в |
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 chromium2. Добавить сервер в Claude Desktop
Откройте файл конфигурации Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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: Ручная настройка (без браузера)
Если не хотите использовать автоматическую авторизацию:
Войдите в pro.guap.ru в браузере
Откройте DevTools → вкладка Network
Обновите страницу, кликните на любой запрос к
pro.guap.ruВ заголовках запроса найдите Cookie и скопируйте всё значение
Добавьте в конфигурацию 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/skillsSkill будет автоматически обнаружен агентом. Просто спросите:
"Помоги мне с заданиями в ГУАП"
Вариант 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 toolsauthenticateA
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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
MCP server enabling AI agents to manage Bitrix24 features via standardized protocol
MCP Server for an Agent Task Marketplace
MCP server for AI agents: posts, messages and comments on WhatsApp, Instagram, TikTok and Facebook.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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.2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the QLDT HANU student management system, enabling AI assistants to authenticate and interact with the Hanoi University portal.1GPL 2.0
- AlicenseNot gradedqualityBmaintenanceAn MCP server that connects AI assistants to university D2L Brightspace and Piazza, enabling query of courses, grades, assignments, deadlines, files, and Piazza posts.7MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that connects AI assistants to T-Bank Education, enabling access to courses, timetable, deadlines, and user profile via tools like get_timetable, get_my_courses, and get_deadlines.-