MCP-сервер для управления кластерами Proxmox VE через помощников ИИ, таких как Claude, Cursor и Cline.

Обеспечить, управлять и контролировать всю инфраструктуру Proxmox с помощью естественного языка. Создавайте виртуальные машины и контейнеры, управляйте снимками, просматривайте хранилище и многое другое.

Быстрый старт

Конфигурация

Установите эти переменные среды (или создайте файл .env):

Необязательно:

Создание токена API Proxmox

1. Войдите в свой веб-интерфейс Proxmox
2. Перейти в Дата-центр** Разрешения***** Токены API**
3. Нажмите Add и создайте токен для вашего пользователя
4. ** Отключить ** “Разделение привилегий” для полного доступа или назначить конкретные разрешения:

• VM.Audit - читать статус VM/CT и конфигурацию — VM.PowerMgmt — start/stop/shutdown/reboot VM.Snapshot — создавать/откатывать/удалять снимки
• [[Т4]] - создавать/удалять/клонировать ВМ и контейнеры [[Т5]] — операции с клонами Datastore.Audit — список хранилищ и просмотр контента Datastore.AllocateSpace — выделение дискового пространства для новых виртуальных машин/КТ Sys.Audit — читать статус узла и задачи VM.Config.Disk — диски с изменением размера VM.Config.CPU — изменение распределения ЦП VM.Config.Memory — изменение распределения памяти
• ВМ.

mcp-proxmox

MCP server for managing Proxmox VE clusters through AI assistants like Claude, Cursor, and Cline.

Provision, manage, and monitor your entire Proxmox infrastructure through natural language. Create VMs and containers, manage snapshots, browse storage, and more.

Quick Start

# Run directly with uvx (no install needed)
uvx mcp-proxmox

# Or install with pip
pip install mcp-proxmox

Configuration

Set these environment variables (or create a .env file):

PROXMOX_HOST=192.168.1.100          # Your Proxmox VE host
PROXMOX_TOKEN_ID=user@pam!mcp       # API token ID
PROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  # API token secret

Optional:

PROXMOX_PORT=8006                   # Default: 8006
PROXMOX_VERIFY_SSL=false            # Default: false

Creating a Proxmox API Token

1. Log into your Proxmox web UI
2. Go to Datacenter > Permissions > API Tokens
3. Click Add and create a token for your user
4. Uncheck “Privilege Separation” for full access, or assign specific permissions:
   • VM.Audit — read VM/CT status and config
   • VM.PowerMgmt — start/stop/shutdown/reboot
   • VM.Snapshot — create/rollback/delete snapshots
   • VM.Allocate — create/delete/clone VMs and containers
   • VM.Clone — clone operations
   • Datastore.Audit — list storages and browse content
   • Datastore.AllocateSpace — allocate disk space for new VMs/CTs
   • Sys.Audit — read node status and tasks
   • VM.Config.Disk — resize disks
   • VM.Config.CPU — change CPU allocation
   • VM.Config.Memory — change memory allocation
   • VM.Monitor — access QEMU monitor (for metrics)
   • VM.Console — console interaction tools (screenshots, keyboard input)
   • VM.Migrate — migrate VMs/CTs between nodes
   • Sys.Modify — manage firewall rules
   • VM.Config.Cloudinit — configure cloud-init parameters

Integration

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "proxmox": {
      "command": "uvx",
      "args": ["mcp-proxmox"],
      "env": {
        "PROXMOX_HOST": "192.168.1.100",
        "PROXMOX_TOKEN_ID": "user@pam!mcp",
        "PROXMOX_TOKEN_SECRET": "your-token-secret"
      }
    }
  }
}

Claude Code

Add to .claude/settings.json or ~/.claude/settings.json:

{
  "mcpServers": {
    "proxmox": {
      "command": "uvx",
      "args": ["mcp-proxmox"],
      "env": {
        "PROXMOX_HOST": "192.168.1.100",
        "PROXMOX_TOKEN_ID": "user@pam!mcp",
        "PROXMOX_TOKEN_SECRET": "your-token-secret"
      }
    }
  }
}

Cursor

Add to Cursor Settings > MCP with the same configuration as above.