Arch Mcp
@nihalxkumar
Arch MCP provides three main capabilities:
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
Sneak Peak into what's available
Claude Desktop (no terminal)
VS Code (with terminal)
Resources (URI-based Access)
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) |
Tools (Executable Functions)
| 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 |
Prompts (Guided Workflows)
| 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 |
Installation
Prerequisites
- Python 3.11+
- uv (recommended) or pip
Quick Install with uvx
uvx arch-ops-server
Configuration
Claude / Cursor / Any MCP client that supports STDIO transport
{
"mcpServers": {
"arch-ops": {
"command": "uvx",
"args": ["arch-ops-server"]
}
}
}
Contributing
Contributions are greatly appreciated. Please feel free to submit a pull request or open an issue and help make things better for everyone.
