Back to MCP Servers

Arch

Arch Linux MCP Server to the Arch Linux ecosystem of the Arch Wiki, AUR, and official repositories for AI-assisted Arch Linux usage on Arch and non-Arch systems. Features include searching Arch Wiki and AUR, getting package info, checking for updates, installing packages securel…

coding-agentsai
By nihalxkumar
4911Updated 3 months agoPythonGPL-3.0

Installation

npx -y arch-mcp

Configuration

{
  "mcpServers": {
    "arch-mcp": {
      "command": "npx",
      "args": ["-y", "arch-mcp"]
    }
  }
}

How to use

  1. Run the installation command above (if needed)
  2. Open your Claude Code settings file (~/.claude/settings.json)
  3. Add the configuration to the mcpServers section
  4. Restart Claude Code to apply changes

README

View on GitHub

Arch Linux MCP Server

PyPI Downloads

<a href="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@nihalxkumar/arch-mcp/badge" /> </a>

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

<details> <summary>Using VS Code Sonnet 3.5 for Safe Installation from AUR</summary>

VS Code Demo

</details> <details> <summary> Asking Claude Code Sonnet 4.5 for fedora equivalent command </summary>

Equivalent Command Demo

</details>

Resources (URI-based Access)

Direct access to Arch ecosystem data via custom URI schemes:

Documentation & Search

URI SchemeExampleReturns
archwiki://archwiki://Installation_guideMarkdown-formatted Wiki page

Package Information

URI SchemeExampleReturns
archrepo://archrepo://vimOfficial repository package details
aur://*/infoaur://yay/infoAUR package metadata (votes, maintainer, dates)
aur://*/pkgbuildaur://yay/pkgbuildRaw PKGBUILD with safety analysis

System Packages (Arch only)

URI SchemeExampleReturns
pacman://installedpacman://installedSystem installed packages list
pacman://orphanspacman://orphansOrphaned packages
pacman://explicitpacman://explicitExplicitly installed packages
pacman://groupspacman://groupsAll package groups
pacman://group/*pacman://group/base-develPackages in specific group
pacman://database/freshnesspacman://database/freshnessPackage database sync status

System Monitoring & Logs

URI SchemeExampleReturns
system://infosystem://infoSystem information (kernel, memory, uptime)
system://disksystem://diskDisk space usage statistics
system://services/failedsystem://services/failedFailed systemd services
system://logs/bootsystem://logs/bootRecent boot logs
pacman://log/recentpacman://log/recentRecent package transactions
pacman://log/failedpacman://log/failedFailed package transactions

News & Updates

URI SchemeExampleReturns
archnews://latestarchnews://latestLatest Arch Linux news
archnews://criticalarchnews://criticalCritical news requiring manual intervention
archnews://since-updatearchnews://since-updateNews since last system update

Configuration

URI SchemeExampleReturns
config://pacmanconfig://pacmanParsed pacman.conf configuration
config://makepkgconfig://makepkgParsed makepkg.conf configuration
mirrors://activemirrors://activeCurrently configured mirrors
mirrors://healthmirrors://healthMirror configuration health status

Tools (Executable Functions)

Package Search & Information

ToolDescriptionPlatform
search_archwikiQuery Arch Wiki with ranked resultsAny
search_aurSearch AUR (relevance/votes/popularity/modified)Any
get_official_package_infoGet official package details (hybrid local/remote)Any

Package Lifecycle Management

ToolDescriptionPlatform
check_updates_dry_runCheck for available updatesArch only
install_package_secureInstall with security checks (blocks malicious packages)Arch only
remove_packagesRemove packages - accepts single package name or list (with deps, forced)Arch only

Package Analysis & Maintenance

ToolDescriptionPlatform
manage_orphansManage orphaned packages (2 actions: list orphaned packages, remove orphans). Always runs in dry-run mode first for safety.Arch only
verify_package_integrityCheck file integrity (modified/missing files)Arch only
manage_install_reasonManage install reasons (3 actions: list explicit packages, mark as explicit/dependency)Arch only

Package Organization

ToolDescriptionPlatform
query_file_ownershipUnified file-package ownership queries (3 modes: file→package, package→files, filename search)Arch only
list_package_groupsList all groups (base, base-devel, etc.)Arch only
list_group_packagesShow packages in specific groupArch only

System Monitoring & Diagnostics

ToolDescriptionPlatform
get_system_infoSystem info (kernel, memory, uptime)Any
check_disk_spaceDisk usage with warningsAny
get_pacman_cache_statsPackage cache size and ageArch only
check_failed_servicesFind failed systemd servicessystemd
get_boot_logsRetrieve journalctl boot logssystemd
check_database_freshnessCheck package database sync statusArch only

Transaction History & Logs

ToolDescriptionPlatform
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_name='docker' shows when docker was installed/upgraded; query_type='failures' shows failed operations; query_type='sync' shows database sync history.Arch only

News & Safety Checks

ToolDescriptionPlatform
get_latest_newsFetch Arch Linux news from RSSAny
check_critical_newsFind critical news (manual intervention required)Any
get_news_since_last_updateNews posted since last system updateArch only

Mirror Management

ToolDescriptionPlatform
optimize_mirrorsSmart 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.Arch/Any

Configuration Management

ToolDescriptionPlatform
analyze_pacman_confParse pacman.conf settings with optional focus. Examples: focus='full' (default) returns all settings; `f

…

View source on GitHub

You might also like

Owlex
MCP Servers
Netops
MCP Servers
Intlayer
MCP Servers