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.
Syncthing security audit step 1 - initial package search and metadata analysis

Step 1: Initial Package Search Using Multiple Tools

Syncthing security audit step 2 - package metadata evaluation and trust score

Step 2: Metadata Analysis of AUR Package

Syncthing security audit step 3 - Security Assesment Report Generated

Step 3: Security Assessment Report Generated

Syncthing security audit step 4 - comprehensive security assessment and recommendations

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.
PKGBUILD safety analysis example showing security threat detection

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.
Arch Wiki documentation reading example showing comprehensive search workflow

Example of reading Arch Wiki documentation

​
Search AUR

Uses the search_aur tool with safety warnings automatically included to find popular alternatives.
Example showing multiple browser search results

Example of finding browsers through comprehensive search

​
Find Alternatives

Combines wiki search, official packages, and AUR search to find the best solution.
Find alternatives search example showing comprehensive search workflow

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.).
Cross-distro package translation example showing Fedora to Arch command conversion

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.
Python official package information example showing version and dependency details

Example of checking official Python package information

​
AUR Package Info

Gets metadata including votes, maintainer, age, and status to help evaluate package quality.
Obsidian AUR package analysis example showing metadata evaluation

Example of analyzing AUR package metadata for Obsidian

​
Compare Packages

Combines multiple tools for comprehensive comparison between official and AUR packages.
Package comparison example showing official vs AUR package analysis

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.
System update check example showing pending package updates

Example of checking system updates

​
Analyze Dependencies

Uses the analyze_dependencies prompt workflow to map out all required packages.
Dependency analysis example showing package dependency mapping

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.
Hidden gems discovery example showing lesser-known but useful 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