ProxmoxMCP-Plus

Overview

ProxmoxMCP-Plus provides a unified interface for controlling Proxmox VE infrastructure through both MCP and OpenAPI protocols. It supports VM and LXC lifecycle management, snapshot operations, backup workflows, ISO management, and container command execution. The server implements a dual-surface architecture allowing conversational workflows through MCP clients and standard automation through HTTP/OpenAPI endpoints. It features persistent job tracking for long-running tasks and includes safety mechanisms for container command execution.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• create_vm

  Create a new virtual machine in Proxmox VE

  Try:Create a Ubuntu VM with 2GB RAM and 1 CPUTry:Create a Windows 10 VM with 50GB disk space
• start_vm

  Start a virtual machine in Proxmox VE

  Try:Start the test-vm serverTry:Power on the development VM
• stop_vm

  Stop a virtual machine in Proxmox VE

  Try:Stop the test-vm serverTry:Shut down the development VM
• delete_vm

  Delete a virtual machine from Proxmox VE

  Try:Delete the test-vm serverTry:Remove the development VM
• create_snapshot

  Create a snapshot of a virtual machine or container

  Try:Create a snapshot of the database VM before updatesTry:Backup the container state
• rollback_snapshot

  Roll back a virtual machine or container to a previous snapshot

  Try:Rollback the database VM to yesterday's snapshotTry:Restore container to last backup
• delete_snapshot

  Delete a snapshot from a virtual machine or container

  Try:Delete the old snapshot from test-vmTry:Remove the temporary backup snapshot
• create_lxc

  Create a new Linux container in Proxmox VE

  Try:Create a Ubuntu container with 1GB RAMTry:Make a Debian LXC for testing
• start_lxc

  Start a Linux container in Proxmox VE

  Try:Start the database containerTry:Boot up the web server container
• stop_lxc

  Stop a Linux container in Proxmox VE

  Try:Stop the database containerTry:Shut down the web server container
• delete_lxc

  Delete a Linux container from Proxmox VE

  Try:Delete the test containerTry:Remove the old development container
• list_jobs

  List all persistent jobs tracked by the server

  Try:Show me all running jobsTry:List completed tasks from today

Comparable tools

Installation

pip install proxmox-mcp-plus
proxmox-mcp-plus

docker run --rm -p 8811:8811 \
  -e PROXMOX_API_KEY="$(openssl rand -hex 32)" \
  -v "$(pwd)/proxmox-config/config.json:/app/proxmox-config/config.json:ro" \
  ghcr.io/rekklesna/proxmoxmcp-plus:latest

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "python",
      "args": ["/path/to/ProxmoxMCP-Plus/main.py"],
      "env": {
        "PROXMOX_MCP_CONFIG": "/path/to/ProxmoxMCP-Plus/proxmox-config/config.json"
      }
    }
  }
}

FAQ

What authentication methods does ProxmoxMCP-Plus support?

It uses Proxmox API tokens with username, token_name, and token_value. For container command execution, it supports SSH authentication with keys.

How are long-running tasks handled?

The server implements a persistent job store (default: SQLite) that tracks task status, progress, and retry information. Jobs can be listed, polled, canceled, or retried via MCP tools or OpenAPI endpoints.

Compare ProxmoxMCP-Plus with