> ## 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.

# Try Examples

> Test with common use cases and examples

Test the Arch MCP Server with these common use cases.

## Security Examples

### Complete Security Audit Workflow

```
I want to install Syncthing for file sync, but I'm paranoid about security. Can you do a full security check?
```

Uses the `audit_aur_package` prompt to perform comprehensive security analysis including metadata evaluation, PKGBUILD analysis, and risk assessment.

<Columns cols={2}>
  <Frame caption="Step 1: Initial Package Search 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="Step 2: Metadata Analysis of AUR Package">
    <img src="https://mintcdn.com/nxk/Vo7X5QKYuFq4P3Oj/images/examples/syncthing2.png?fit=max&auto=format&n=Vo7X5QKYuFq4P3Oj&q=85&s=9b55c2ed805b0de770fdad6e01fd935d" alt="Syncthing security audit step 2 - package metadata evaluation and trust score" style={{ borderRadius: '0.5rem', width: '100%' }} width="837" height="828" data-path="images/examples/syncthing2.png" />
  </Frame>

  <Frame caption="Step 3: Security Assessment Report Generated">
    <img src="https://mintcdn.com/nxk/Vo7X5QKYuFq4P3Oj/images/examples/syncthing3.png?fit=max&auto=format&n=Vo7X5QKYuFq4P3Oj&q=85&s=5bbfb091fede6bc8b9c49c08fec83fe1" alt="Syncthing security audit step 3 - Security Assesment Report Generated" style={{ borderRadius: '0.5rem', width: '100%' }} width="837" height="828" data-path="images/examples/syncthing3.png" />
  </Frame>

  <Frame caption="Step 4: Decision left on user with complete guide">
    <img src="https://mintcdn.com/nxk/Vo7X5QKYuFq4P3Oj/images/examples/syncthing4.png?fit=max&auto=format&n=Vo7X5QKYuFq4P3Oj&q=85&s=74a263c56a7b2690bd6ec64f5d46b673" alt="Syncthing security audit step 4 - comprehensive security assessment and recommendations" style={{ borderRadius: '0.5rem', width: '100%' }} width="837" height="835" data-path="images/examples/syncthing4.png" />
  </Frame>
</Columns>

### Analyze PKGBUILD

```
My friend sent me this PKGBUILD for a custom app, can you check if it's safe to install?
```

Uses the `audit_package_security` tool with `action='pkgbuild_analysis'` to detect malicious patterns and suspicious code.

<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>

### Audit AUR Package

```
I found this random package called 'crypto-miner-helper' on AUR, should I trust it?
```

Uses the `audit_aur_package` prompt to:

1. Fetch package metadata
2. Analyze PKGBUILD for threats
3. Provide security recommendations

## Search Examples

### Search Arch Wiki

```
give me gnu pass documentation
```

Reads `archwiki://Pass` resource and combines with other tools comprehensive documenation.

<Frame caption="Example of reading Arch Wiki documentation">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/wiki-docs.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=f3f46bb62050a8c4763b07db204a0ea0" alt="Arch Wiki documentation reading example showing comprehensive search workflow" style={{ borderRadius: '0.5rem' }} width="940" height="819" data-path="images/examples/wiki-docs.png" />
</Frame>

### Search AUR

Uses the `search_aur` tool with safety warnings automatically included to find popular alternatives.

```
Do we have any AI browser in AUR?
```

<Frame caption="Example of finding browsers through comprehensive search">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/browser-search.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=8ccd19e63c4835a0d3122ae94a389b7e" alt="Example showing multiple browser search results" style={{ borderRadius: '0.5rem' }} width="601" height="832" data-path="images/examples/browser-search.png" />
</Frame>

### Find Alternatives

```
I need a web server for my project, what are my options and what does the Arch Wiki recommend?
```

Combines wiki search, official packages, and AUR search to find the best solution.

<Frame caption="Example of finding alternatives through comprehensive search">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/find_alternatives.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=2c014342a539bbb1c5c4f0d12408267c" alt="Find alternatives search example showing comprehensive search workflow" style={{ borderRadius: '0.5rem' }} width="855" height="866" data-path="images/examples/find_alternatives.png" />
</Frame>

### Cross-Distro Package Translation

```
I have this Fedora command with multiple packages, can you give me the equivalent command for Arch Linux?
```

Searches both official repositories and AUR to find equivalent packages for commands from other distributions (Fedora, Ubuntu, Debian, etc.).

<Frame caption="Example of translating Fedora package installation command to Arch Linux equivalent">
  <img src="https://mintcdn.com/nxk/WXulAj1ONUoioQNu/videos/equivalent-commands.gif?s=c42d147edc97176306a9f2162506d320" alt="Cross-distro package translation example showing Fedora to Arch command conversion" style={{ borderRadius: '0.5rem' }} width="1392" height="761" data-path="videos/equivalent-commands.gif" />
</Frame>

## Package Info and Install Examples

### Official Package

```
I want to install Python for development, what version is available in the official repos?
```

Uses `get_official_package_info` tool for official repository packages to check versions and dependencies.

<Frame caption="Example of checking official Python package information">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/python-repos.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=a7202345bd404f0a2006329e28961efa" alt="Python official package information example showing version and dependency details" style={{ borderRadius: '0.5rem' }} width="723" height="768" data-path="images/examples/python-repos.png" />
</Frame>

### AUR Package Info

```
I found this cool note-taking app called 'obsidian' in AUR, is it well-maintained?
```

Gets metadata including votes, maintainer, age, and status to help evaluate package quality.

<Frame caption="Example of analyzing AUR package metadata for Obsidian">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/obsidian-analysis.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=857b4323a72a72a515a815657399ae9e" alt="Obsidian AUR package analysis example showing metadata evaluation" style={{ borderRadius: '0.5rem' }} width="723" height="768" data-path="images/examples/obsidian-analysis.png" />
</Frame>

### Compare Packages

```
I'm looking for a good text editor - should I go with the official vim package or is there a better AUR version?
```

Combines multiple tools for comprehensive comparison between official and AUR packages.

<Frame caption="Example of comparing packages between official and AUR repositories">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/compare_packages.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=d98231edc5de3e870430a4ad821849d1" alt="Package comparison example showing official vs AUR package analysis" style={{ borderRadius: '0.5rem' }} width="855" height="866" data-path="images/examples/compare_packages.png" />
</Frame>

### Check Updates

```
I haven't updated in a while, what packages need updating on my system?
```

Uses `check_updates_dry_run` tool (read-only, safe operation) to see pending updates.

<Frame caption="Example of checking system updates">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/check_update_dry_run.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=09c1bb6e0fecccb91f8fc21fbba59bbe" alt="System update check example showing pending package updates" style={{ borderRadius: '0.5rem' }} width="854" height="855" data-path="images/examples/check_update_dry_run.png" />
</Frame>

### Analyze Dependencies

```
I want to set up a development environment with Docker, what all do I need to install?
```

Uses the `analyze_dependencies` prompt workflow to map out all required packages.

<Frame caption="Example of analyzing package dependencies for development environment setup">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/dependency-analysis.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=719045d191737f23bcc706fdfb95db45" alt="Dependency analysis example showing package dependency mapping" style={{ borderRadius: '0.5rem' }} width="705" height="785" data-path="images/examples/dependency-analysis.png" />
</Frame>

### Have fun exploring

```
I'm looking for some interesting or lesser-known packages that might be useful for my workflow
```

Uses AUR search with different sorting methods to discover popular but less mainstream packages.

<Frame caption="Example of discovering hidden gems in AUR">
  <img src="https://mintcdn.com/nxk/pBLV8x_ZKJSFKjz7/images/examples/hidden-gems.png?fit=max&auto=format&n=pBLV8x_ZKJSFKjz7&q=85&s=69522da1b6fd6240f0fa516f14ada376" alt="Hidden gems discovery example showing lesser-known but useful packages" style={{ borderRadius: '0.5rem' }} width="843" height="864" data-path="images/examples/hidden-gems.png" />
</Frame>

## Stuck somewhere?

<Accordion title="AUR search returns no results?">
  The package might not exist, or the AUR might be temporarily unavailable. Try:

  * Double-check package name spelling
  * Search for similar names
  * Try a few minutes later
</Accordion>

<Accordion title="Tool not working?">
  1. Verify uvx installation: `uvx --version`
  2. Restart your MCP client (Claude Desktop, Cursor, etc.)
  3. Verify arch-ops appears in connected MCP servers
  4. Check logs in your client for specific errors
  5. Try reinstalling: `uvx --reinstall arch-ops-server`
</Accordion>

<Accordion title="Getting timeout errors?">
  1. Check internet connection
  2. Try a simpler query first
  3. Verify Arch Wiki and AUR are accessible
</Accordion>

<Card title="Troubleshooting" icon="wrench" href="/arch-mcp/troubleshoot">
  Common issues and solutions
</Card>
