arch-mcp
JSON →An AI-powered bridge to the Arch Linux ecosystem that enables intelligent package management, AUR access, and Arch Wiki queries through the Model Context Protocol (MCP).
Install
uvx arch-ops-server Tools · 27
- search_archwiki Query Arch Wiki with ranked results
- search_aur Search AUR (relevance/votes/popularity/modified)
- get_official_package_info Get official package details (hybrid local/remote)
- check_updates_dry_run Check for available updates
- install_package_secure Install with security checks (blocks malicious packages)
- remove_packages Remove packages - accepts single package name or list (with deps, forced)
- manage_orphans Manage orphaned packages (2 actions: list orphaned packages, remove orphans). Always runs in dry-run mode first for safety.
- verify_package_integrity Check file integrity (modified/missing files)
- manage_install_reason Manage install reasons (3 actions: list explicit packages, mark as explicit/dependency)
- query_file_ownership Unified file-package ownership queries (3 modes: file→package, package→files, filename search)
- list_package_groups List all groups (base, base-devel, etc.)
- list_group_packages Show packages in specific group
- get_system_info System info (kernel, memory, uptime)
- check_disk_space Disk usage with warnings
- get_pacman_cache_stats Package cache size and age
- check_failed_services Find failed systemd services
- get_boot_logs Retrieve journalctl boot logs
- check_database_freshness Check package database sync status
- query_package_history Unified tool for querying package history from pacman logs (4 query types). Examples: `query_type='all'` shows recent transactions; `query_type='package', package_name='docker'` shows when docker was installed/upgraded; `query_type='failures'` shows failed operations; `query_type='sync'` shows database sync history.
- get_latest_news Fetch Arch Linux news from RSS
- check_critical_news Find critical news (manual intervention required)
- get_news_since_last_update News posted since last system update
- optimize_mirrors Smart mirror management (4 actions: status, test, suggest, health). Examples: `optimize_mirrors(action='status', auto_test=True)` lists and tests all mirrors; `optimize_mirrors(action='suggest', country='US', limit=5)` suggests top 5 US mirrors; `optimize_mirrors(action='health')` checks for issues and gives recommendations.
- analyze_pacman_conf Parse pacman.conf settings with optional focus. Examples: `focus='full'` (default) returns all settings; `focus='ignored_packages'` returns only ignored packages with warnings for critical ones; `focus='parallel_downloads'` returns only parallel downloads setting with optimization recommendations.
- analyze_makepkg_conf Parse makepkg.conf settings (CFLAGS, MAKEFLAGS, build configuration)
- analyze_pkgbuild_safety Comprehensive PKGBUILD analysis (50+ red flags)
- analyze_package_metadata_risk Package trust scoring (votes, maintainer, age)
Links
★ 46 GitHub stars