Skip to main content
Test the Arch MCP Server with these common use cases.

​
Security Examples

​
Complete Security Audit Workflow

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

Step 1: Initial Package Search Using Multiple Tools

Step 2: Metadata Analysis of AUR Package

Step 3: Security Assessment Report Generated

Step 4: Decision left on user with complete guide

​
Analyze PKGBUILD

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

Example of PKGBUILD safety analysis

​
Audit AUR Package

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

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

Example of reading Arch Wiki documentation

​
Search AUR

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

Example of finding browsers through comprehensive search

​
Find Alternatives

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

Example of finding alternatives through comprehensive search

​
Cross-Distro Package Translation

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

Example of translating Fedora package installation command to Arch Linux equivalent

​
Package Info and Install Examples

​
Official Package

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

Example of checking official Python package information

​
AUR Package Info

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

Example of analyzing AUR package metadata for Obsidian

​
Compare Packages

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

Example of comparing packages between official and AUR repositories

​
Check Updates

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

Example of checking system updates

​
Analyze Dependencies

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

Example of analyzing package dependencies for development environment setup

​
Have fun exploring

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

Example of discovering hidden gems in AUR

​
Stuck somewhere?

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
  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
  1. Check internet connection
  2. Try a simpler query first
  3. Verify Arch Wiki and AUR are accessible

Troubleshooting

Common issues and solutions