PVE MCP Server

A Model Context Protocol (MCP) server for managing Proxmox Virtual Environment (PVE).

Features

• Cluster: View cluster status and resources

• Nodes: List nodes, get detailed node status

• QEMU VMs: List, status, config, start, stop, shutdown, reboot, suspend, resume

• LXC Containers: List, status, config, start, stop, shutdown, reboot

• Storage: List storage pools, browse storage content

• Tasks: View recent tasks and task status

• Version: Get PVE version info

Related MCP server: ProxmoxMCP-Plus

Setup

1. Create a PVE API Token

In the Proxmox web UI:

1. Go to Datacenter → Permissions → API Tokens

2. Click Add

3. Select a user (e.g. root@pam), give the token a name (e.g. mcp)

4. Uncheck "Privilege Separation" if you want the token to inherit the user's permissions

5. Copy the token ID and secret value

2. Install

cd pve-mcp
python3 -m venv venv
venv/bin/pip install -e .

3. Configure Environment Variables

export PVE_HOST="your-proxmox-host"
export PVE_USER="root@pam"
export PVE_TOKEN_NAME="mcp"
export PVE_TOKEN_VALUE="your-token-secret"
# Optional:
export PVE_PORT="8006"         # default: 8006
export PVE_VERIFY_SSL="false"  # default: false

4. Run

python run_mcp_server.py

5. Add to Warp

In Warp Settings → MCP Servers, add a new server with:

{
  "pve": {
    "command": "python",
    "args": ["/Users/gneely/git/pve-mcp/run_mcp_server.py"],
    "env": {
      "PVE_HOST": "your-proxmox-host",
      "PVE_USER": "root@pam",
      "PVE_TOKEN_NAME": "mcp",
      "PVE_TOKEN_VALUE": "your-token-secret"
    }
  }
}

Available Tools