README.md
Bridges AI assistants with the Arch Linux ecosystem.
Arch Linux MCP Server
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
Using VS Code Sonnet 3.5 for Safe Installation from AUR
Asking Claude Code Sonnet 4.5 for fedora equivalent command
Resources (URI-based Access)
Direct access to Arch ecosystem data via custom URI schemes:
Documentation & Search
| URI Scheme | Example | Returns |
|---|---|---|
archwiki:// |
archwiki://Installation_guide |
Markdown-formatted Wiki page |
Package Information
| URI Scheme | Example | Returns |
|---|---|---|
archrepo:// |
archrepo://vim |
Official repository package details |
aur://*/info |
aur://yay/info |
AUR package metadata (votes, maintainer, dates) |
aur://*/pkgbuild |
aur://yay/pkgbuild |
Raw PKGBUILD with safety analysis |
System Packages (Arch only)
| URI Scheme | Example | Returns |
|---|---|---|
pacman://installed |
pacman://installed |
System installed packages list |
pacman://orphans |
pacman://orphans |
Orphaned packages |
pacman://explicit |
pacman://explicit |
Explicitly installed packages |
pacman://groups |
pacman://groups |
All package groups |
pacman://group/* |
pacman://group/base-devel |
Packages in specific group |
pacman://database/freshness |
pacman://database/freshness |
Package database sync status |
System Monitoring & Logs
| URI Scheme | Example | Returns |
|---|---|---|
system://info |
system://info |
System information (kernel, memory, uptime) |
system://disk |
system://disk |
Disk space usage statistics |
system://services/failed |
system://services/failed |
Failed systemd services |
system://logs/boot |
system://logs/boot |
Recent boot logs |
pacman://log/recent |
pacman://log/recent |
Recent package transactions |
pacman://log/failed |
pacman://log/failed |
Failed package transactions |
News & Updates
| URI Scheme | Example | Returns |
|---|---|---|
archnews://latest |
archnews://latest |
Latest Arch Linux news |
archnews://critical |
archnews://critical |
Critical news requiring manual intervention |
archnews://since-update |
archnews://since-update |
News since last system update |
Configuration
| URI Scheme | Example | Returns |
|---|---|---|
config://pacman |
config://pacman |
Parsed pacman.conf configuration |
config://makepkg |
config://makepkg |
Parsed makepkg.conf configuration |
mirrors://active |
mirrors://active |
Currently configured mirrors |
mirrors://health |
mirrors://health |
Mirror configuration health status |
Tools (Executable Functions)
Pack
Tools (4)
search_arch_wikiSearch the Arch Wiki for documentation and guides.get_aur_infoRetrieve metadata and package details from the AUR.list_installed_packagesList packages currently installed on the system.check_failed_servicesIdentify failed systemd services.Configuration
claude_desktop_config.json
{"mcpServers": {"arch-linux": {"command": "uvx", "args": ["arch-ops-server"]}}}Try it
āSearch the Arch Wiki for the installation guide for sway.
āGet the AUR package details for yay and check if it is safe to install.
āList all orphaned packages on my system.
āCheck if there are any failed systemd services that need attention.
āShow me the latest critical news from the Arch Linux website.