Arch Mcp
@nihalxkumar
About Arch Mcp
Arch MCP provides three main capabilities:
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"arch-ops": {
"command": "uvx",
"args": [
"arch-ops-server"
]
}
}
}Tools
41Search 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 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 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 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 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 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 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 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 multiple packages in a single transaction. More efficient than removing packages one by one. Only works on Arch Linux. Requires sudo access.
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 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 which package owns a specific file on the system. Useful for troubleshooting and understanding file origins. Only works on Arch Linux.
List all files owned by a package. Supports optional filtering by pattern. Only works on Arch Linux.
Search for files across all packages in repositories. Requires package database sync (pacman -Fy). Only works on Arch Linux.
Verify the integrity of installed package files. Detects modified, missing, or corrupted files. Only works on Arch Linux.
List all available package groups (e.g., base, base-devel, gnome). Only works on Arch Linux.
List all packages in a specific group. Only works on Arch Linux.
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 a package as explicitly installed. Prevents it from being removed as an orphan. Only works on Arch Linux.
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 comprehensive system information including kernel version, architecture, hostname, uptime, and memory statistics. Works on any system.
Check disk space usage for critical filesystem paths including root, home, var, and pacman cache. Warns when space is low. Works on any system.
Analyze pacman package cache statistics including size, package count, and cache age. Only works on Arch Linux.
Check for failed systemd services. Useful for diagnosing system issues. Works on systemd-based systems.
Retrieve recent boot logs from journalctl. Useful for troubleshooting boot issues. Works on systemd-based systems.
Fetch recent Arch Linux news from RSS feed. Returns title, date, summary, and link for each news item.
Check for critical Arch Linux news requiring manual intervention. Scans recent news for keywords: 'manual intervention', 'action required', 'breaking change', etc.
Get news posted since last pacman update. Parses /var/log/pacman.log for last update timestamp. Only works on Arch Linux.
Get recent package transactions from pacman log. Shows installed, upgraded, and removed packages. Only works on Arch Linux.
Find when a package was first installed and its upgrade history. Only works on Arch Linux.
Find failed package transactions in pacman log. Only works on Arch Linux.
Get database synchronization history. Shows when 'pacman -Sy' was run. Only works on Arch Linux.
List currently configured mirrors from mirrorlist. Only works on Arch Linux.
Test mirror response time. Can test a specific mirror or all active mirrors. Only works on Arch Linux.
Suggest optimal mirrors based on official mirror status from archlinux.org. Filters by country if specified.
Verify mirror configuration health. Checks for common issues like no active mirrors, outdated mirrorlist, high latency. Only works on Arch Linux.
Parse and analyze pacman.conf. Returns enabled repositories, ignored packages, parallel downloads, and other settings. Only works on Arch Linux.
Parse and analyze makepkg.conf. Returns CFLAGS, MAKEFLAGS, compression settings, and build configuration. Only works on Arch Linux.
List packages ignored in updates from pacman.conf. Warns if critical system packages are ignored. Only works on Arch Linux.
Get parallel downloads configuration from pacman.conf and provide recommendations. Only works on Arch Linux.
Check when package databases were last synchronized. Warns if databases are stale (> 24 hours). Only works on Arch Linux.
Overview
What is Arch Mcp?
Arch Mcp is an unofficial community MCP server that bridges AI assistants with the Arch Linux ecosystem. It provides intelligent, safe access to the Arch Wiki, Arch User Repository (AUR), and official repositories, enabling both Arch and non-Arch systems to retrieve structured, digestible results for Arch‑related queries.
How to use Arch Mcp?
Install via uvx arch-ops-server (requires Python 3.11+ and uv). Configure your MCP client (e.g., Claude, Cursor) with STDIO transport using the command uvx and arguments ["arch-ops-server"]. Once configured, the server exposes resources, tools, and prompts for Arch‑ecosystem interactions.
Key features of Arch Mcp
- URI‑based resources for Arch Wiki (
archwiki://), AUR (aur://), official repos (archrepo://), and installed packages (pacman://installed) - Search tools for Arch Wiki, AUR, and official packages
- System tool
check_updates_dry_runfor read‑only update checks (Arch only) - Secure package installation tool with auto security checks (
install_package_secure) - PKGBUILD safety analysis with detection of 50+ red flags
- Guided prompts for troubleshooting, pre‑installation audits, and dependency planning
Use cases of Arch Mcp
- Query Arch Wiki documentation and get ranked, markdown‑formatted results
- Search AUR packages with smart ranking by relevance, votes, and popularity
- Safely analyze PKGBUILD files and package metadata before installing
- Diagnose system errors by extracting keywords and searching the Wiki contextually
- Plan installations by mapping repository dependencies and suggesting install order
FAQ from Arch Mcp
What does Arch Mcp do that alternatives don’t?
It combines direct URI access to Arch Wiki, AUR, and official packages with AI‑friendly tools and prompts, including safety analysis for PKGBUILD and package trust scoring.
Is Arch Mcp an official Arch Linux project?
No. It is an unofficial community project and is not affiliated with Arch Linux.
What are the runtime requirements?
Python 3.11 or higher, and the uv tool (recommended) or pip for installation.
How is the server transported and configured?
It uses STDIO transport. Configure your MCP client with "command": "uvx" and "args": ["arch-ops-server"].
Are there any system‑specific limitations?
Tools like check_updates_dry_run and install_package_secure work only on Arch Linux systems; resource‑based queries function on any system.
More Other MCP servers
ICSS
chokcoco不止于 CSS
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
EverArt
modelcontextprotocolModel Context Protocol Servers
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Comments