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
claude mcp add proxmox-aiops -- uvx proxmox-aiopsWhat 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-aiopsuvx runs the command named after the package; if the README names another one, use uvx --from proxmox-aiops <command>
Platform CLI
codex mcp add proxmox-aiops -- uvx proxmox-aiopsuvx runs the command named after the package; if the README names another one, use uvx --from proxmox-aiops <command>
Config file
{
"mcpServers": {
"proxmox-aiops": {
"command": "uvx",
"args": [
"proxmox-aiops"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from proxmox-aiops <command>
Config file
{
"servers": {
"proxmox-aiops": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-aiops"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from proxmox-aiops <command>
Platform CLI
gemini mcp add proxmox-aiops uvx proxmox-aiopsuvx 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.