# nihalxkumar/arch-mcp [Health: Active]

**Category:** 🤖 Coding Agents  
**Repository:** https://github.com/nihalxkumar/arch-mcp  
**GitHub Stars:** 57  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/nihalxkumar-arch-mcp

## Description
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 securely, and analyzing PKGBUILDs.

## Tools
Capabilities this server exposes over MCP:

- **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 data…
- **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…
- **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)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "arch-mcp": {
    "command": "uvx",
    "args": ["arch-ops-server"]
  }
}
```

## Documentation

## What nihalxkumar/arch-mcp MCP server does

nihalxkumar/arch-mcp MCP server gives MCP-compatible AI assistants access to several parts of the Arch Linux ecosystem. It can search the Arch Wiki and AUR, retrieve official repository package information, inspect package metadata, and analyze PKGBUILD safety. The project describes itself as an unofficial community project and states that it is not affiliated with Arch Linux.

The server also exposes local package and system operations where the host supports them. These include checking for updates, securely installing packages, removing packages, managing orphaned packages, verifying package integrity, inspecting package ownership, and reviewing package history. System-oriented functions cover kernel and memory information, disk usage, pacman cache statistics, failed systemd services, boot logs, package database freshness, mirror health, and pacman or makepkg configuration.

## How it works

The server exposes executable MCP tools for actions and query workflows. Search tools are available on any platform according to the supplied tool table, while many pacman operations are marked Arch-only. System information and disk checks are also listed as available on any platform; service and boot-log functions require systemd.

In addition to tools, nihalxkumar/arch-mcp MCP server provides URI-based resources. Examples include `archwiki://` for Wiki pages, `archrepo://` for official package details, and `aur://` for AUR metadata or raw PKGBUILDs. Local package resources use `pacman://`, system diagnostics use `system://`, news uses `archnews://`, configuration uses `config://`, and mirror data uses `mirrors://`.

Safety-oriented workflows include dry-run update checks, dry-run orphan management, package installation checks that block malicious packages, and PKGBUILD analysis covering more than 50 red flags. Package metadata risk analysis considers information such as votes, maintainer, and package age.

## Tools and capabilities

The available capabilities include:

- Search ranked Arch Wiki results and query the AUR using relevance, votes, popularity, or modification date.
- Retrieve official package details using local and remote data sources.
- Install or remove packages, manage orphaned packages, and change explicit or dependency installation reasons on Arch systems.
- Inspect package files, ownership relationships, groups, integrity problems, cache statistics, and transaction history.
- Review system details, disk space, failed services, boot logs, database freshness, mirrors, and package-manager configuration.
- Read current, critical, or post-update Arch news.
- Analyze PKGBUILD safety and package metadata risk.

## Limitations and notes

Arch-only tools are not equivalent to general package-management tools on other distributions. The listed platform support should be checked before asking the server to perform local operations. Service and boot-log features depend on systemd. The supplied material does not document authentication requirements, a specific installation command, supported client configuration, or a software license. It also does not establish compatibility with Claude Desktop, Cursor, Windsurf, or Cline.

The project can provide Arch-related information on non-Arch systems, but package lifecycle and pacman resources are identified as Arch-only. Actions that change packages should therefore be treated as host-affecting operations even where the server provides safety checks or dry-run behavior.

_Full upstream README: https://allmcps.com/mcp/nihalxkumar-arch-mcp/readme_