Skip to main content

​
Installation

Install the Arch MCP Server and verify it’s working.

​
Prerequisites

  • Python 3.11+ - Check version: python --version
  • uv - Modern Python package manager (recommended)

​
Install uv

sudo pacman -S uv

​
Manual Installation

Download pre-built binaries from the GitHub Releases page:
  1. Download the appropriate binary for your operating system
  2. Extract the binary to a directory in your PATH
  3. Make the binary executable (Linux/macOS): chmod +x uv

​
Conda/Mamba

If you use conda or mamba, you can install uv from conda-forge:
conda install -c conda-forge uv
# or
mamba install -c conda-forge uv

​
Install Arch MCP Server

Install the Arch MCP Server using uvx: 
uvx arch-ops-server
This command will automatically:
  • Download and install the latest version
  • Set up all required dependencies
  • Make the server available globally

​
Configure MCP Client

Connect your AI assistant to the Arch MCP Server by adding this to your MCP client configuration file: 
{
  "mcpServers": {
    "arch-ops": {
      "command": "uvx",
      "args": ["arch-ops-server"]
    }
  }
}

​
Client-Specific Setup

  • Claude Desktop
  • Cursor
  • VS Code
Config file location:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Steps:
  1. Open the config file in a text editor
  2. Add the JSON configuration above
  3. Save and close
  4. Restart Claude Desktop completely

​
Next Step

Usage Examples

Try common use cases and queries