How do I install nihalxkumar/arch-mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is nihalxkumar/arch-mcp safe to use with an AI agent?

Its trust score is 69 out of 100 (good). It passes 4 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is nihalxkumar/arch-mcp still maintained?

The last commit was 7 months ago and 5 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.

About nihalxkumar/arch-mcp

nihalxkumar/arch-mcp is an MCP server published by nihalxkumar in the Developer Tools category: arch Linux MCP (Model Context Protocol) Server.

The repository has 61 stars and 16 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source

git clone https://github.com/nihalxkumar/arch-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (3)

get_official_package_infoGet official package details (hybrid local/remote)

Parameters not published.

search_archwikiQuery Arch Wiki with ranked results

Parameters not published.

search_aurSearch AUR (relevance/votes/popularity/modified)

Parameters not published.

Ask AI

✦

Ask AI about nihalxkumar/arch-mcp

I know everything about nihalxkumar/arch-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.

✓README presentThe repository ships documentation.
✓License declaredUsable under a stated license.
✓Tests presentA test suite exists in the repository.
✓Dependencies pinnedA lockfile pins dependency versions.
!Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

1 check has not been run yet.

Releases

v3.4.0v3.4.0 · 12 Feb 2026TLDR: This release primarly focuses on tool consolidation along with enhanced security, and improved system diagnostics. 🚀 New Features & Major Consolidations Unified News System: Consolidated multiple news tools into fetch_news,…

v3.0.0v3.0.0 - System Monitoring & Proactive Safety · 10 Nov 2025🚀 Major Release: System Monitoring & Proactive Safety This release adds comprehensive system monitoring, news integration, and proactive safety features for safer Arch Linux management. ✨ New Features 📰 News Integration RSS feed parser for…

v2.0.0v2.0.0 - Package Lifecycle & System Diagnostics · 10 Nov 2025🎉 Major Release This release adds complete package lifecycle management and system diagnostics capabilities to arch-ops-server, transforming it from a search/install tool into a comprehensive Arch Linux administration assistant. ✨ What's…

v1.3.0v1.3.0 - Dual-licensing & Dockerfile standardization · 10 Nov 2025What's Changed Add dual-licensing (GPL-3.0 + MIT) for broader compatibility Standardize Dockerfile naming convention Add SPDX license headers to source files Full Changelog: https://github.com/nihalxkumar/arch-mcp/compare/v0.1.2...v0.1.3

README

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

VS Code Demo

Equivalent Command Demo

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)

Package Search & Information

Tool	Description	Platform
`search_archwiki`	Query Arch Wiki with ranked results	Any
`search_aur`	Search AUR (relevance/votes/popularity/modified)	Any
`get_official_package_info`	Get official package details (hybrid local/remote)	Any

Package Lifecycle Management

Tool	Description	Platform
`check_updates_dry_run`	Check for available updates	Arch only
`install_package_secure`	Install with security checks (blocks malicious packages)	Arch only
`remove_packages`	Remove packages - accepts single package name or list (with deps, forced)	Arch only

Package Analysis & Maintenance

Tool	Description	Platform
`manage_orphans`	Manage orphaned packages (2 actions: list orphaned packages, remove orphans). Always runs in dry-run mode first for safety.	Arch only
`verify_package_integrity`	Check file integrity (modified/missing files)	Arch only
`manage_install_reason`	Manage install reasons (3 actions: list explicit packages, mark as explicit/dependency)	Arch only

Package Organization

Tool	Description	Platform
`query_file_ownership`	Unified file-package ownership queries (3 modes: file→package, package→files, filename search)	Arch only
`list_package_groups`	List all groups (base, base-devel, etc.)	Arch only
`list_group_packages`	Show packages in specific group	Arch only

System Monitoring & Diagnostics

Tool	Description	Platform
`get_system_info`	System info (kernel, memory, uptime)	Any
`check_disk_space`	Disk usage with warnings	Any
`get_pacman_cache_stats`	Package cache size and age	Arch only
`check_failed_services`	Find failed systemd services	systemd
`get_boot_logs`	Retrieve journalctl boot logs	systemd
`check_database_freshness`	Check package database sync status	Arch only

Transaction History & Logs

Tool	Description	Platform
`query_package_history`	Unified tool for querying package history from pacman logs (4 query types). Examples: `query_type='all'` shows recent transactions; `query_type='package', package_name='docker'` shows when docker was installed/upgraded; `query_type='failures'` shows failed operations; `query_type='sync'` shows database sync history.	Arch only

News & Safety Checks

Tool	Description	Platform
`get_latest_news`	Fetch Arch Linux news from RSS	Any
`check_critical_news`	Find critical news (manual intervention required)	Any
`get_news_since_last_update`	News posted since last system update	Arch only

Mirror Management

Tool	Description	Platform
`optimize_mirrors`	Smart mirror management (4 actions: status, test, suggest, health). Examples: `optimize_mirrors(action='status', auto_test=True)` lists and tests all mirrors; `optimize_mirrors(action='suggest', country='US', limit=5)` suggests top 5 US mirrors; `optimize_mirrors(action='health')` checks for issues and gives recommendations.	Arch/Any

Configuration Management

Tool	Description	Platform
`analyze_pacman_conf`	Parse pacman.conf settings with optional focus. Examples: `focus='full'` (default) returns all settings; `focus='ignored_packages'` returns only ignored packages with warnings for critical ones; `focus='parallel_downloads'` returns only parallel downloads setting with optimization recommendations.	Arch only
`analyze_makepkg_conf`	Parse makepkg.conf settings (CFLAGS, MAKEFLAGS, build configuration)	Arch only

Security Analysis

Tool	Description	Platform
`analyze_pkgbuild_safety`	Comprehensive PKGBUILD analysis (50+ red flags)	Any
`analyze_package_metadata_risk`	Package trust scoring (votes, maintainer, age)	Any

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
`safe_system_update`	Safe update workflow	Check critical news → Verify disk space → List updates → Check services → Recommendations

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-linux": {
      "command": "uvx",
      "args": ["arch-ops-server"]
    }
  }
}

Opencode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "arch-linux": {
      "type": "local",
      "command": ["uvx", "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.

Contributing Guide

License

This project is dual-licensed under your choice of:

GPL-3.0-only - For those who prefer strong copyleft protections. See LICENSE-GPL
MIT License - For broader compatibility and adoption, including use in proprietary software and compatibility with platforms like Docker MCP Catalog. See LICENSE-MIT

You may use this software under the terms of either license. When redistributing or modifying this software, you may choose which license to apply.

By contributing to this project, you agree that your contributions will be licensed under both licenses.

Read full README

README fetched from the repository 4 days ago. The original is authoritative.

About nihalxkumar/arch-mcp

Install

Tools (3)

Ask AI

Security checks

Releases

README

Arch Linux MCP Server

Sneak Peak into what's available

Resources (URI-based Access)

Documentation & Search

Package Information

System Packages (Arch only)

System Monitoring & Logs

News & Updates

Configuration

Tools (Executable Functions)

Package Search & Information

Package Lifecycle Management

Package Analysis & Maintenance

Package Organization

System Monitoring & Diagnostics

Transaction History & Logs

News & Safety Checks

Mirror Management

Configuration Management

Security Analysis

Prompts (Guided Workflows)

Installation

Prerequisites

Quick Install with uvx

Configuration

Contributing

License

Alternatives to nihalxkumar/arch-mcp

Gemini CLI

oraios/serena

For Beginners

Skill Seekers

Nginx UI

Xiaozhi Esp32 Server

About nihalxkumar/arch-mcp

Quick Install with `uvx`