> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nihalxkumar.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Arch MCP Server

> AI-powered bridge to the Arch Linux ecosystem with safe package management and security-first workflows

# Arch MCP Server

[![PyPI Downloads](https://static.pepy.tech/personalized-badge/arch-ops-server?period=total\&units=INTERNATIONAL_SYSTEM\&left_color=BLUE\&right_color=BLACK\&left_text=PyPi+Downloads)](https://pepy.tech/projects/arch-ops-server)

**Version:** 3.4.0 | **License:** GPL-3.0-only OR MIT

**Disclaimer:** Unofficial community project, not affiliated with Arch Linux.

A [Model Context Protocol](https://modelcontextprotocol.io/) (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.

<Columns cols={3}>
  <Frame caption="Package Security Check Using Multiple Tools">
    <img src="https://mintcdn.com/nxk/Vo7X5QKYuFq4P3Oj/images/examples/syncthing1.png?fit=max&auto=format&n=Vo7X5QKYuFq4P3Oj&q=85&s=12a871647af03216636bc2d6b9aeb6aa" alt="Syncthing security audit step 1 - initial package search and metadata analysis" style={{ borderRadius: '0.5rem', width: '100%' }} width="839" height="825" data-path="images/examples/syncthing1.png" />
  </Frame>

  <Frame caption="AI-powered assistance for Arch Linux tasks through the MCP protocol">
    <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/wifi-troubleshooting.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=121309be5b55dce7eacdee7461a44fc3" alt="Arch MCP Server in action showing AI-powered Arch Linux assistance" style={{ borderRadius: '0.5rem' }} width="1004" height="819" data-path="images/examples/wifi-troubleshooting.png" />
  </Frame>

  <Frame caption="Example of PKGBUILD safety analysis">
    <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/analyze_pkgbuild_safety.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=783eb1732c9c3322b3ebb933b73136d3" alt="PKGBUILD safety analysis example showing security threat detection" style={{ borderRadius: '0.5rem' }} width="854" height="860" data-path="images/examples/analyze_pkgbuild_safety.png" />
  </Frame>
</Columns>

## What it does

Arch MCP provides three main capabilities:

* **🔍 Resources** - URI-based access to Arch Wiki, AUR packages, official repos, and installed packages
* **🛠️ Tools** - Search, analyze, and securely install packages with built-in safety checks
* **📋 Prompts** - Guided workflows for troubleshooting, security audits, and dependency analysis

<CardGroup cols={3}>
  <Card title="Resources" icon="folder-open" href="/arch-mcp/resources">
    Direct data access through URI schemes
  </Card>

  <Card title="Tools" icon="wrench" href="/arch-mcp/tools">
    Executable functions for specific operations
  </Card>

  <Card title="Prompts" icon="messages" href="/arch-mcp/prompts">
    Intelligent multi-step workflows
  </Card>
</CardGroup>

<Card title="Explore All Features" icon="sparkles" href="/arch-mcp/features" horizontal>
  View detailed documentation of all resources, tools, and prompts
</Card>

## Next Steps

Ready to get started? Follow the installation guide:

<Card title="Installation Guide" icon="rocket" href="/arch-mcp/install">
  Step-by-step installation instructions
</Card>

## Advanced Topics

<CardGroup cols={2}>
  <Card title="Security Features" icon="shield" href="/arch-mcp/secure-installation">
    Learn about safety checks and PKGBUILD analysis
  </Card>

  <Card title="Architecture" icon="sitemap" href="/arch-mcp/architecture">
    Deep dive into design philosophy and system architecture
  </Card>
</CardGroup>

## For Developers

<CardGroup cols={3}>
  <Card title="Development Setup" icon="laptop-code" href="/arch-mcp/development-setup">
    Set up your dev environment and run tests
  </Card>

  <Card title="Code Standards" icon="code" href="/arch-mcp/code-standards">
    Coding standards and best practices
  </Card>

  <Card title="Contributing Guide" icon="users" href="/arch-mcp/contributing">
    How to submit contributions and PRs
  </Card>
</CardGroup>

## License

This project is dual-licensed under your choice of:

* **[GPL-3.0-only](https://www.gnu.org/licenses/gpl-3.0.en.html)** - For those who prefer strong copyleft protections
* **[MIT License](https://opensource.org/licenses/MIT)** - For broader compatibility and adoption, including use in proprietary software and compatibility with platforms like Docker MCP Catalog

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

***

Built with ❤️ for the Arch Linux community