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 output for digestible, structured results that are ready for follow up questions and actions.
📖 Complete Documentation with Comfy Guides
Claude Desktop (no terminal)
VS Code (with terminal)
Direct access to Arch ecosystem data via custom URI schemes:
| URI Scheme | Example | Returns |
|---|---|---|
archwiki:// |
archwiki://Installation_guide |
Markdown-formatted Wiki page |
aur://*/pkgbuild |
aur://yay/pkgbuild |
Raw PKGBUILD with safety analysis |
aur://*/info |
aur://yay/info |
AUR package metadata (votes, maintainer, dates) |
archrepo:// |
archrepo://vim |
Official repository package details |
pacman://installed |
pacman://installed |
System installed packages list (Arch only) |
| Category | Tool | Description | Key Features |
|---|---|---|---|
| Search | search_archwiki |
Query Arch Wiki documentation | Ranked results, keyword extraction |
search_aur |
Search AUR packages | Smart ranking: relevance/votes/popularity/modified | |
get_official_package_info |
Lookup official packages | Hybrid local/remote, detailed metadata | |
| System | check_updates_dry_run |
Check for updates (Arch only) | Read-only, safe, requires pacman-contrib |
| Installation | install_package_secure |
Secure package installation | Auto security checks, blocks malicious packages, uses paru/yay |
| Security | analyze_pkgbuild_safety |
Comprehensive PKGBUILD analysis | Detects: malicious commands based on 50+ red flags |
analyze_package_metadata_risk |
Package trust evaluation | Analyzes: votes, maintainer, age, updates, trust scoring |
| Prompt | Purpose | Workflow |
|---|---|---|
troubleshoot_issue |
Diagnose system errors | Extract keywords → Search Wiki → Context-aware suggestions |
audit_aur_package |
Pre-installation safety audit | Fetch metadata → Analyze PKGBUILD → Security recommendations |
analyze_dependencies |
Installation planning | Check repos → Map dependencies → Suggest install order |
- Python 3.11+
- uv (recommended) or pip
uvx arch-ops-serverClaude / Cursor / Any MCP client that supports STDIO transport
{
"mcpServers": {
"arch-ops": {
"command": "uvx",
"args": ["arch-ops-server"]
}
}
}Contributions are greatly appreciated. Please feel free to submit a pull request or open an issue and help make things better for everyone.