Arch MCP Server

A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that bridges AI assistants with the Arch Linux ecosystem. Enables

Local serverstdioPython

What is the Arch MCP Server?

A Model Context Protocol (MCP) server that bridges AI assistants with the Arch Linux ecosystem. Enables intelligent, safe, and

What it needs from you

  • Python 3.11+ - uv (recommended) or pip

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_archwikiQuery Arch Wiki with ranked results
search_aurSearch AUR (relevance/votes/popularity/modified)
get_official_package_infoGet official package details (hybrid local/remote)
check_updates_dry_runCheck for available updates
install_package_secureInstall with security checks (blocks malicious packages)
remove_packagesRemove packages - accepts single package name or list (with deps, forced)
manage_orphansManage orphaned packages (2 actions: list orphaned packages, remove orphans). Always runs in dry-run mode first for safety.
verify_package_integrityCheck file integrity (modified/missing files)
manage_install_reasonManage install reasons (3 actions: list explicit packages, mark as explicit/dependency)
query_file_ownershipUnified file-package ownership queries (3 modes: file→package, package→files, filename search)
list_package_groupsList all groups (base, base-devel, etc.)
list_group_packagesShow packages in specific group
get_system_infoSystem info (kernel, memory, uptime)
check_disk_spaceDisk usage with warnings
get_pacman_cache_statsPackage cache size and age
check_failed_servicesFind failed systemd services
get_boot_logsRetrieve journalctl boot logs
check_database_freshnessCheck package database sync status
query_package_historyUnified tool for querying package history from pacman logs (4 query types). Examples: query_type='all' shows recent transactions; query_type='package', package_
get_latest_newsFetch Arch Linux news from RSS
check_critical_newsFind critical news (manual intervention required)
get_news_since_last_updateNews posted since last system update
optimize_mirrorsSmart mirror management (4 actions: status, test, suggest, health). Examples: optimize_mirrors(action='status', auto_test=True) lists and tests all mirrors; opt
analyze_pacman_confParse pacman.conf settings with optional focus. Examples: focus='full' (default) returns all settings; focus='ignored_packages' returns only ignored packages wi
analyze_makepkg_confParse makepkg.conf settings (CFLAGS, MAKEFLAGS, build configuration)
analyze_pkgbuild_safetyComprehensive PKGBUILD analysis (50+ red flags)
analyze_package_metadata_riskPackage trust scoring (votes, maintainer, age)

How to install the Arch MCP Server

{
  "mcpServers": {
    "arch-linux": {
      "command": "uvx",
      "args": [
        "arch-ops-server"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.11+ - uv (recommended) or pip

Example prompts to try

  • “Use Arch MCP to Configuration.”
  • “Use Arch MCP to Prerequisites.”

Frequently asked questions

A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that bridges AI assistants with the Arch Linux ecosystem. Enables intelligent, safe, and Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.