Skip to main content
MCP server CX Codex

Proxmox AIops — Claude Code MCP server: what it does, how to install

Proxmox AIops is a Claude Code MCP server that handles Proxmox VE VM and container lifecycle operations. It executes infrastructure tasks with built-in audit logs and risk-tier safeguards.

MIT ★ 5 updated 2026-11-14

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add proxmox-aiops -- uvx proxmox-aiops
Open on GitHub

What Proxmox AIops does

This tool automates Proxmox VE management through 43 MCP tools while recording every operation in a local ~/.proxmox-aiops/audit.db file. Each action receives a risk-tier label, and destructive operations support dry runs and mandatory confirmation.

It handles configuration via CLI and provides diagnostics for node pressure or guest health. The system includes runaway budget guards to prevent infinite poll loops and manages encrypted secrets, ensuring no plaintext credentials reside in the config.yaml file.

To run the server, ensure uv is installed and available in your PATH. You must also set up a config.yaml file with cluster details and a separate secrets file in ~/.proxmox-aiops/ with 600 permissions.

What it helps with

  • automate VM and container lifecycle management
  • perform cluster node health and pressure diagnostics
  • rollback operations using undo descriptors
  • manage backup creation and restoration

Example prompts for the agent

  • Use the MCP server to list all virtual machines in the Proxmox cluster
  • Run diagnostics on cluster node pressure
  • Execute a backup of a specific virtual machine

How to install Proxmox AIops

Platform CLI

claude mcp add proxmox-aiops -- uvx proxmox-aiops

uvx runs the command named after the package; if the README names another one, use uvx --from proxmox-aiops <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Proxmox AIops

How to install Proxmox AIops in Claude Code?

Run the command claude mcp add proxmox-aiops -- uvx proxmox-aiops.

What does Proxmox AIops do?

It provides a suite of tools for managing Proxmox VE virtual machines and containers, enforcing strict audit logging and risk assessment for every operation.

What is required to use Proxmox AIops?

You need uv in your PATH, a properly configured config.yaml file, and a secrets file in ~/.proxmox-aiops/ with 600 permissions.

Similar MCP servers

All MCP servers for DevOps and infrastructure →

Project sponsors

Companies that keep this analytics open