The Arch Linux MCP server enables AI assistants to safely access and interact with the Arch Linux ecosystem including the Arch Wiki, AUR packages, and official repositories.
Search & Information Retrieval: Query Arch Wiki documentation and AUR packages with smart ranking by relevance, votes, popularity, or modification date
Secure Package Management: Install packages with comprehensive security checks, prioritizing official repositories and automatically auditing AUR packages before installation
System Maintenance: Perform safe, read-only checks for available system updates on Arch Linux systems
Security Analysis: Analyze PKGBUILD files for malicious commands, dangerous patterns, and suspicious network activity, plus evaluate package trustworthiness based on metadata
Direct URI Access: Retrieve specific resources using custom URI schemes (archwiki://, aur://, archrepo://) for Wiki pages, PKGBUILDs, and package details
Guided Workflows: Execute pre-built prompts for troubleshooting, dependency analysis, and pre-installation safety audits
Cross-Platform Support: Works on both Arch and non-Arch systems (with some Arch-specific features requiring Arch Linux)
Provides comprehensive access to the Arch Linux ecosystem including searching and accessing Arch Wiki documentation, browsing AUR packages with security analysis, querying official repositories, managing system packages, and performing security audits of PKGBUILDs and package metadata.
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
Direct access to Arch ecosystem data via custom URI schemes:
URI Scheme | Example | Returns |
|
| Markdown-formatted Wiki page |
URI Scheme | Example | Returns |
|
| Official repository package details |
|
| AUR package metadata (votes, maintainer, dates) |
|
| Raw PKGBUILD with safety analysis |
URI Scheme | Example | Returns |
|
| System installed packages list |
|
| Orphaned packages |
|
| Explicitly installed packages |
|
| All package groups |
|
| Packages in specific group |
|
| Package database sync status |
URI Scheme | Example | Returns |
|
| System information (kernel, memory, uptime) |
|
| Disk space usage statistics |
|
| Failed systemd services |
|
| Recent boot logs |
|
| Recent package transactions |
|
| Failed package transactions |
URI Scheme | Example | Returns |
|
| Latest Arch Linux news |
|
| Critical news requiring manual intervention |
|
| News since last system update |
URI Scheme | Example | Returns |
|
| Parsed pacman.conf configuration |
|
| Parsed makepkg.conf configuration |
|
| Currently configured mirrors |
|
| Mirror configuration health status |
Tool | Description | Platform |
| Query Arch Wiki with ranked results | Any |
| Search AUR (relevance/votes/popularity/modified) | Any |
| Get official package details (hybrid local/remote) | Any |
Tool | Description | Platform |
| Check for available updates | Arch only |
| Install with security checks (blocks malicious packages) | Arch only |
| Remove single package (with deps, forced) | Arch only |
| Remove multiple packages efficiently | Arch only |
Tool | Description | Platform |
| Find orphaned packages | Arch only |
| Clean orphans (dry-run, exclusions) | Arch only |
| Check file integrity (modified/missing files) | Arch only |
| List user-installed packages | Arch only |
| Prevent package from being orphaned | Arch only |
| Allow package to be orphaned | Arch only |
Tool | Description | Platform |
| Find which package owns a file | Arch only |
| List files in package (regex filtering) | Arch only |
| Search files across packages | Arch only |
| List all groups (base, base-devel, etc.) | Arch only |
| Show packages in specific group | Arch only |
Tool | Description | Platform |
| System info (kernel, memory, uptime) | Any |
| Disk usage with warnings | Any |
| Package cache size and age | Arch only |
| Find failed systemd services | systemd |
| Retrieve journalctl boot logs | systemd |
| Check package database sync status | Arch only |
Tool | Description | Platform |
| Recent package transactions (install/upgrade/remove) | Arch only |
| Package installation history | Arch only |
| Failed package operations | Arch only |
| Database sync events | Arch only |
Tool | Description | Platform |
| Fetch Arch Linux news from RSS | Any |
| Find critical news (manual intervention required) | Any |
| News posted since last system update | Arch only |
Tool | Description | Platform |
| Show configured mirrors | Arch only |
| Test mirror latency | Arch only |
| Recommend optimal mirrors by location | Any |
| Verify mirror configuration | Arch only |
Tool | Description | Platform |
| Parse pacman.conf settings | Arch only |
| Parse makepkg.conf settings | Arch only |
| List ignored packages (warns on critical) | Arch only |
| Get parallel download config | Arch only |
Tool | Description | Platform |
| Comprehensive PKGBUILD analysis (50+ red flags) | Any |
| Package trust scoring (votes, maintainer, age) | Any |
Prompt | Purpose | Workflow |
| Diagnose system errors | Extract keywords → Search Wiki → Context-aware suggestions |
| Pre-installation safety audit | Fetch metadata → Analyze PKGBUILD → Security recommendations |
| Installation planning | Check repos → Map dependencies → Suggest install order |
| Safe update workflow | Check critical news → Verify disk space → List updates → Check services → Recommendations |
Python 3.11+
uv (recommended) or pip
uvxClaude / Cursor / Any MCP client that supports STDIO transport
Contributions are greatly appreciated. Please feel free to submit a pull request or open an issue and help make things better for everyone.
This project is dual-licensed under your choice of:
GPL-3.0-only - See LICENSE-GPL
MIT License - See LICENSE-MIT
You may use this software under the terms of either license. See LICENSE for more details.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Arch MCP provides three main capabilities:
Access to Arch Wiki, AUR packages, official repos, and installed packages
Search, analyze, and securely install packages with built-in 50+ safety checks
Guided workflows for troubleshooting, security audits, and dependency analysis
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/nihalxkumar/arch-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server