nihalxkumar/arch-mcp

[CONFIG] Разбирает и анализирует файл makepkg.conf. Возвращает CFLAGS, MAKEFLAGS, настройки сжатия и конфигурацию сборки. Работает только в Arch Linux. Возвращает: CFLAGS, MAKEFLAGS, настройки сжатия и конфигурацию каталога сборки.

[CONFIG] Разбирает и анализирует pacman.conf с опциональным focus. Возвращает включённые репозитории, игнорируемые пакеты, параллельные загрузки и другие настройки. Работает только в Arch Linux. Примеры: focus='full' (по умолчанию) возвращает все настройки; focus='ignored_packages' возвращает только игнорируемые пакеты с предупреждениями о критических; focus='parallel_downloads' возвращает только настройку параллельных загрузок с рекомендациями по оптимизации.

[MONITORING] Универсальный инструмент анализа хранилища. Действия: disk_usage (проверяет дисковое пространство для критических путей), cache_stats (анализирует кеш пакетов pacman). Работает на любой системе для disk_usage, только на Arch для cache_stats.

[SECURITY] Комплексный аудит безопасности для пакетов AUR. Действия: pkgbuild_analysis (сканирует PKGBUILD на 50+ красных флагов), metadata_risk (оценивает доверие через голоса/мейнтейнера/возраст). Примеры: audit_package_security(action='pkgbuild_analysis', pkgbuild_content='...'), audit_package_security(action='metadata_risk', package_name='yay'). ⚠️ Всегда проверяйте пакеты AUR на безопасность перед установкой.

[MAINTENANCE] Проверяет, когда базы данных пакетов синхронизировались в последний раз. Предупреждает, если базы данных устарели (более 24 часов). Работает только на Arch Linux. Когда использовать: проверьте, устарела ли база данных pacman (более 7 дней) и нуждается ли в 'pacman -Sy'.

[LIFECYCLE] Проверяет доступные обновления системы без их установки. Работает только на системах Arch Linux. Требует пакет pacman-contrib. Безопасная операция только для чтения, показывающая ожидающие обновления. Когда использовать: перед запуском обновлений системы проверяет, какие пакеты будут обновлены и их размеры.

[MONITORING] Унифицированная диагностика системы для systemd-систем. Действия: failed_services (проверяет отказавшие службы systemd), boot_logs (получает последние журналы загрузки). Работает только на systemd-системах.

[DISCOVERY] Унифицированное получение новостей из Arch Linux. Действия: latest (получить последние новости), critical (найти новости, требующие ручного вмешательства), since_update (новости с момента последнего обновления системы). Работает на любой системе для latest/critical, только на Arch для since_update.

[DISCOVERY] Получает информацию об официальном пакете репозитория Arch (Core, Extra и т.д.). Использует локальный pacman, если доступен, иначе запрашивает API archlinux.org. Всегда предпочитает официальные пакеты пакетам из AUR, если официальные доступны. Пример запроса: 'python' возвращает версию, зависимости, размер установки и расположение репозитория.

[МОНИТОРИНГ] Получает полную информацию о системе: версию ядра, архитектуру, имя хоста, время работы и статистику памяти. Работает на любой системе. Возвращает: версию Arch, ядро, архитектуру, версию pacman, количество установленных пакетов, использование диска.

[LIFECYCLE] Устанавливает пакет с комплексными проверками безопасности. Рабочий процесс: 1. Сначала проверяет официальные репозитории (безопаснее) 2. Для пакетов AUR: получает метаданные, анализирует оценку доверия, получает PKGBUILD, анализирует безопасность 3. Блокирует установку, если найдены критические проблемы безопасности 4. Проверяет наличие AUR-хелпера (paru > yay) 5. Устанавливает с флагом --noconfirm, если все проверки пройдены. Работает только на Arch Linux. Требует доступ sudo и paru/yay для пакетов AUR.

[ORGANIZATION] Единый инструмент управления группами. Действия: list_groups (все группы), list_packages_in_group (пакеты в конкретной группе). Примеры: manage_groups(action='list_groups'), manage_groups(action='list_packages_in_group', group_name='base-devel')

[ОБСЛУЖИВАНИЕ] Единый инструмент для управления причинами установки пакетов. Поддерживает три действия: 'list' (перечисляет все явно установленные пакеты), 'mark_explicit' (запрещает удаление пакета как осиротевшего) и 'mark_dependency' (разрешает автоматическое удаление пакета с осиротевшими). Работает только на Arch Linux. Примеры: action='list' → возвращает все установленные пользователем пакеты; action='mark_explicit', package_name='python-pip' → сохраняет пакет даже при изменении зависимостей; action='mark_dependency', package_name='lib32-gcc-libs' → разрешает автоматическое удаление с осиротевшими.

[MAINTENANCE] Унифицированный инструмент для управления осиротевшими пакетами (зависимостями, которые больше не нужны). Поддерживает два действия: 'list' (показать осиротевшие пакеты) и 'remove' (удалить осиротевшие пакеты). Работает только в Arch Linux. Требует sudo для удаления. Примеры: action='list' — показывает все осиротевшие пакеты с указанием занимаемого места; action='remove', dry_run=true — предварительный просмотр того, что будет удалено; action='remove', dry_run=false, exclude=['pkg1'] — удаляет все осиротевшие пакеты, кроме 'pkg1'.

[MIRRORS] Управление зеркалами - объединяет 4 операции с зеркалами. Действия: 'status' (список настроенных зеркал), 'test' (тестирование скорости зеркал), 'suggest' (получение оптимальных зеркал с archlinux.org), 'health' (полная проверка работоспособности). Примеры: optimize_mirrors(action='status', auto_test=True) выводит список и тестирует все зеркала; optimize_mirrors(action='suggest', country='US', limit=5) предлагает 5 лучших зеркал в США; optimize_mirrors(action='health') проверяет наличие проблем и даёт рекомендации.

[ORGANIZATION] Унифицированный инструмент для запроса отношений владения файлов и пакетов. Поддерживает три режима: 'file_to_package' (находит пакет, которому принадлежит файл), 'package_to_files' (выводит все файлы в пакете с опциональной фильтрацией) и 'filename_search' (ищет файлы по всем пакетам). Работает только на Arch Linux. Примеры: mode='file_to_package', query='/usr/bin/python' → возвращает пакет 'python'; mode='package_to_files', query='systemd', filter_pattern='*.service' → выводит все служебные файлы systemd; mode='filename_search', query='*.desktop' → находит все пакеты, содержащие .desktop-файлы.

[HISTORY] Единый инструмент для запроса истории пакетов из логов pacman. Поддерживает четыре типа запросов: 'all' (последние транзакции), 'package' (история установки/обновления конкретного пакета), 'failures' (неудачные транзакции) и 'sync' (история синхронизации базы данных). Работает только на Arch Linux. Примеры: query_type='all', limit=50 — последние транзакции; query_type='package', package_name='docker' — когда был установлен docker; query_type='failures' — поиск ошибок; query_type='sync', limit=20 — история синхронизации.

[LIFECYCLE] Унифицированный инструмент для удаления пакетов (одного или нескольких). Принимает либо одно имя пакета, либо список пакетов. Поддерживает удаление с зависимостями и принудительное удаление. Работает только в Arch Linux. Требует доступа sudo. Примеры: packages='firefox', remove_dependencies=true → удаляет Firefox вместе с зависимостями; packages=['pkg1', 'pkg2', 'pkg3'] → массовое удаление нескольких пакетов; packages='lib', force=true → принудительное удаление с игнорированием зависимостей (опасно!).

[МОНИТОРИНГ] Выполняет всестороннюю проверку работоспособности системы. Объединяет несколько диагностик, чтобы предоставить полный обзор состояния системы, включая дисковое пространство, отказавшие службы, обновления, осиротевшие пакеты и другое. Работает только в Arch Linux. Всесторонняя проверка: доступные обновления, дисковое пространство, отказавшие службы, свежесть базы данных, осиротевшие пакеты и критические новости.

[DISCOVERY] Ищет документацию в Arch Wiki. Возвращает список подходящих страниц с заголовками, фрагментами и URL. Отдаёт предпочтение результатам из Wiki, а не общим веб-знаниям для проблем, специфичных для Arch. Пример: выполните поиск 'pacman hooks', чтобы найти документацию по созданию пользовательских хуков pacman.

[DISCOVERY] Ищет пакеты в Arch User Repository (AUR) с умной сортировкой. ⚠️ ПРЕДУПРЕЖДЕНИЕ: Пакеты AUR создаются пользователями и могут быть небезопасными. Возвращает информацию о пакетах, включая количество голосов, мейнтейнера и дату последнего обновления. Сначала всегда проверяйте официальные репозитории с помощью get_official_package_info. Пример использования: перед установкой 'spotify' выполните поиск в AUR, чтобы сравнить пакеты, такие как 'spotify', 'spotify-launcher' и 'spotify-adblock'.

[ТЕХОБСЛУЖИВАНИЕ] Проверяет целостность установленных файлов пакетов. Обнаруживает изменённые, отсутствующие или повреждённые файлы. Работает только в Arch Linux. Когда использовать: После сбоя системы или ошибок диска, проверяйте, что файлы пакета 'linux' соответствуют ожидаемым контрольным суммам.