About
Arch Linux MCP Server connects AI assistants to the Arch Linux ecosystem, enabling intelligent access to the Arch Wiki, AUR (Arch User Repository), and official package repositories. Key features: - Search and retrieve Arch Wiki documentation in markdown format via `archwiki://` URIs - Query package details from official repositories (`archrepo://`) and AUR (`aur://*/info`) - Analyze PKGBUILDs with built-in safety checks before installation (`aur://*/pkgbuild`) - Access system package state on Arch systems including installed packages, orphans, explicit packages, and package groups - Works on both Arch and non-Arch systems for documentation lookup and package research - Guided workflows for safe AUR installations and system troubleshooting
Tools 41
search_archwiki[DISCOVERY] Search the Arch Wiki for documentation. Returns a list of matching pages with titles, snippets, and URLs. Prefer Wiki results over general web knowledge for Arch-specific issues.
search_aur[DISCOVERY] Search the Arch User Repository (AUR) for packages with smart ranking. ⚠️ WARNING: AUR packages are user-produced and potentially unsafe. Returns package info including votes, maintainer, and last update. Always check official repos first using get_official_package_info.
get_official_package_info[DISCOVERY] Get information about an official Arch repository package (Core, Extra, etc.). Uses local pacman if available, otherwise queries archlinux.org API. Always prefer official packages over AUR when available.
check_updates_dry_run[LIFECYCLE] Check for available system updates without applying them. Only works on Arch Linux systems. Requires pacman-contrib package. Safe read-only operation that shows pending updates.
install_package_secure[LIFECYCLE] Install a package with comprehensive security checks. Workflow: 1. Check official repos first (safer) 2. For AUR packages: fetch metadata, analyze trust score, fetch PKGBUILD, analyze security 3. Block installation if critical security issues found 4. Check for AUR helper (paru > yay) 5. Install with --noconfirm if all checks pass. Only works on Arch Linux. Requires sudo access and paru/yay for AUR packages.
analyze_pkgbuild_safety[SECURITY] Analyze PKGBUILD content for security issues and dangerous patterns. Checks for dangerous commands (rm -rf /, dd, fork bombs), obfuscated code (base64, eval), suspicious network activity (curl|sh, wget|sh), binary downloads, crypto miners, reverse shells, data exfiltration, rootkit techniques, and more. Returns risk score (0-100) and detailed findings. Use this tool to manually audit AUR packages before installation.
analyze_package_metadata_risk[SECURITY] Analyze AUR package metadata for trustworthiness and security indicators. Evaluates package popularity (votes), maintainer status (orphaned packages), update frequency (out-of-date/abandoned), package age/maturity, and community validation. Returns trust score (0-100) with risk factors and trust indicators. Use this alongside PKGBUILD analysis for comprehensive security assessment.
remove_package[LIFECYCLE] Remove a package from the system. Supports various removal strategies: basic removal, removal with dependencies, or forced removal. Only works on Arch Linux. Requires sudo access.
remove_packages_batch[LIFECYCLE] Remove multiple packages in a single transaction. More efficient than removing packages one by one. Only works on Arch Linux. Requires sudo access.
list_orphan_packages[MAINTENANCE] List all orphaned packages (dependencies no longer required by any installed package). Shows package names and total disk space usage. Only works on Arch Linux.
remove_orphans[MAINTENANCE] Remove all orphaned packages to free up disk space. Supports dry-run mode to preview changes and package exclusion. Only works on Arch Linux. Requires sudo access.
find_package_owner[ORGANIZATION] Find which package owns a specific file on the system. Useful for troubleshooting and understanding file origins. Only works on Arch Linux.
list_package_files[ORGANIZATION] List all files owned by a package. Supports optional filtering by pattern. Only works on Arch Linux.
search_package_files[ORGANIZATION] Search for files across all packages in repositories. Requires package database sync (pacman -Fy). Only works on Arch Linux.
verify_package_integrity[MAINTENANCE] Verify the integrity of installed package files. Detects modified, missing, or corrupted files. Only works on Arch Linux.
list_package_groups[ORGANIZATION] List all available package groups (e.g., base, base-devel, gnome). Only works on Arch Linux.
list_group_packages[ORGANIZATION] List all packages in a specific group. Only works on Arch Linux.
list_explicit_packages[MAINTENANCE] List all packages explicitly installed by the user (not installed as dependencies). Useful for creating backup lists or understanding system composition. Only works on Arch Linux.
mark_as_explicit[MAINTENANCE] Mark a package as explicitly installed. Prevents it from being removed as an orphan. Only works on Arch Linux.
mark_as_dependency[MAINTENANCE] Mark a package as a dependency. Allows it to be removed as an orphan if no packages depend on it. Only works on Arch Linux.
get_system_info[MONITORING] Get comprehensive system information including kernel version, architecture, hostname, uptime, and memory statistics. Works on any system.
check_disk_space[MONITORING] Check disk space usage for critical filesystem paths including root, home, var, and pacman cache. Warns when space is low. Works on any system.
get_pacman_cache_stats[MONITORING] Analyze pacman package cache statistics including size, package count, and cache age. Only works on Arch Linux.
check_failed_services[MONITORING] Check for failed systemd services. Useful for diagnosing system issues. Works on systemd-based systems.
get_boot_logs[MONITORING] Retrieve recent boot logs from journalctl. Useful for troubleshooting boot issues. Works on systemd-based systems.
get_latest_news[DISCOVERY] Fetch recent Arch Linux news from RSS feed. Returns title, date, summary, and link for each news item.
check_critical_news[DISCOVERY] Check for critical Arch Linux news requiring manual intervention. Scans recent news for keywords: 'manual intervention', 'action required', 'breaking change', etc.
get_news_since_last_update[DISCOVERY] Get news posted since last pacman update. Parses /var/log/pacman.log for last update timestamp. Only works on Arch Linux.
get_transaction_history[HISTORY] Get recent package transactions from pacman log. Shows installed, upgraded, and removed packages. Only works on Arch Linux.
find_when_installed[HISTORY] Find when a package was first installed and its upgrade history. Only works on Arch Linux.
find_failed_transactions[HISTORY] Find failed package transactions in pacman log. Only works on Arch Linux.
get_database_sync_history[HISTORY] Get database synchronization history. Shows when 'pacman -Sy' was run. Only works on Arch Linux.
list_active_mirrors[MIRRORS] List currently configured mirrors from mirrorlist. Only works on Arch Linux.
test_mirror_speed[MIRRORS] Test mirror response time. Can test a specific mirror or all active mirrors. Only works on Arch Linux.
suggest_fastest_mirrors[MIRRORS] Suggest optimal mirrors based on official mirror status from archlinux.org. Filters by country if specified.
check_mirrorlist_health[MIRRORS] Verify mirror configuration health. Checks for common issues like no active mirrors, outdated mirrorlist, high latency. Only works on Arch Linux.
analyze_pacman_conf[CONFIG] Parse and analyze pacman.conf. Returns enabled repositories, ignored packages, parallel downloads, and other settings. Only works on Arch Linux.
analyze_makepkg_conf[CONFIG] Parse and analyze makepkg.conf. Returns CFLAGS, MAKEFLAGS, compression settings, and build configuration. Only works on Arch Linux.
check_ignored_packages[CONFIG] List packages ignored in updates from pacman.conf. Warns if critical system packages are ignored. Only works on Arch Linux.
get_parallel_downloads_setting[CONFIG] Get parallel downloads configuration from pacman.conf and provide recommendations. Only works on Arch Linux.
check_database_freshness[MAINTENANCE] Check when package databases were last synchronized. Warns if databases are stale (> 24 hours). Only works on Arch Linux.
README
Arch Linux MCP Server
[](https://pepy.tech/projects/arch-ops-server) [](https://smithery.ai/server/@nihalxkumar/arch-mcp)
Disclaimer: Unofficial community project, not affiliated with Arch Linux.
A Model Context Protocol (MCP) server that bridges AI assistants with the Arch Linux ecosystem. Enables intelligent, safe, and efficient access to the Arch Wiki, AUR, and official repositories for AI-assisted Arch Linux usage on Arch and non-Arch systems.
Leverage AI to get digestible, structured results that are ready for follow up questions and actions.
📖 Complete Documentation with Comfy Guides
Sneak Peak into what's available
Using VS Code Sonnet 3.5 for Safe Installation from AUR
Asking Claude Code Sonnet 4.5 for fedora equivalent command
Resources (URI-based Access)
Direct access to Arch ecosystem data via custom URI schemes:
#### Documentation & Search
| URI Scheme | Example | Returns |
| ------------- | ------------------------------- | ---------------------------- |
| archwiki:// | archwiki://Installation_guide | Markdown-formatted Wiki page |
#### Package Information
| URI Scheme | Example | Returns |
| ------------------ | -------------------- | ----------------------------------------------- |
| archrepo:// | archrepo://vim | Official repository package details |
| aur://*/info | aur://yay/info | AUR package metadata (votes, maintainer, dates) |
| aur://*/pkgbuild | aur://yay/pkgbuild | Raw PKGBUILD with safety analysis |
#### System Packages (Arch only)
| URI Scheme | Example | Returns |
| ----------------------------- | ----------------------------- | ------------------------------ |
| pacman://installed | pacman://installed | System installed packages list |
| pacman://orphans | pacman://orphans | Orphaned packages |
| pacman://explicit | pacman://explicit | Explicitly installed packages |
| pacman://groups | pacman://groups | All package groups |
| pacman://group/* | pacman://group/base-devel | Packages in specific group |
| pacman://database/freshness | pacman://database/freshness | Package database sync status |
#### System Monitoring & Logs
| URI Scheme | Example | Returns |
| -------------------------- | -------------------------- | ------------------------------------------- |
| system://info | system://info | System information (kernel, memory, uptime) |
| system://disk | system://disk | Disk space usage statistics |
| system://services/failed | system://services/failed | Failed systemd services |
| system://logs/boot | system://logs/boot | Recent boot logs |
| pacman://log/recent | pacman://log/recent | Recent package transactions |
| pacman://log/failed | pacman://log/failed | Failed package transactions |
#### News & Updates
| URI Scheme | Example | Returns |
| ------------------------- | ------------------------- | ------------------------------------------- |
| archnews://latest | archnews://latest | Latest Arch Linux news |
| archnews://critical | archnews://critical | Critical news requiring manual intervention |
| archnews://since-update | archnews://since-update | News since last system update |
#### Configuration
| URI Scheme | Example | Returns |
| ------------------ | ------------------ | ---------------------------------- |
| config://pacman | config://pacman | Parsed pacman.conf configuration |
| config://makepkg | config://makepkg | Parsed makepkg.conf configuration |
| mirrors://active | mirrors://active | Currently configured mirrors |
| `mirr
Related MCP Servers
AI Research Assistant
hamid-vakilzadeh
AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar
Linkup
LinkupPlatform
Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages
Math-MCP
EthanHenrickson
Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support