# Proxmox AIops

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: AIops-tools
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AIops-tools/Proxmox-AIops
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/proxmox-aiops

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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>

### Codex

**Platform CLI**
```bash
codex 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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini 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>

## When to use it
- 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
- 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

## Similar
- [Proxmox VE](https://affpapa.org/en/nevibecode/mcp/proxmox-ve.md) — MCP server · ★ 8 repo stars
- [proxmox-admin](https://affpapa.org/en/nevibecode/skills/proxmox-admin.md) — skill · 886 installs
- [Proximo — the Proxmox MCP you can hand the keys](https://affpapa.org/en/nevibecode/mcp/proximo-the-proxmox-mcp-you-can-hand-the-keys.md) — MCP server · ★ 96 repo stars
- [mcp-proxmox](https://affpapa.org/en/nevibecode/mcp/mcp-proxmox.md) — MCP server · ★ 17 repo stars
- [Proxmox MCP](https://affpapa.org/en/nevibecode/mcp/proxmox-mcp.md) — MCP server · ★ 87 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
