Files

nearxos dab31bf8d3 Initial proxmox-mcp: MCP server for vessel troubleshoot stack.

Part of GeneseasX golden-vessel tooling (see homelab-vault Projects/vessel-troubleshoot-stack).

2026-06-12 22:54:08 +03:00

1.4 KiB

Raw Blame History

proxmox-mcp

MCP server for Proxmox VE 9 — nodes, VMs, LXCs, status, exec. Sibling of pfsense-mcp.

Quick start

cd ~/Projects/proxmox-mcp
python3 -m venv .venv && .venv/bin/pip install -e .

Cursor (`~/.cursor/mcp.json`)

"proxmox": {
  "command": "/Users/nearxos/Projects/proxmox-mcp/.venv/bin/proxmox-mcp",
  "env": {
    "PROXMOX_VERIFY_SSL": "false",
    "PROXMOX_ALLOW_WRITES": "false",
    "PROXMOX_TARGETS_PATH": "/Users/nearxos/.local/share/proxmox-mcp/targets.json"
  }
}

Connect

proxmox_connect(
  url="https://10.20.30.254:8006",
  token_id="root@pam!cursor",
  token_secret="...",
  name="golden-proxmox"
)
proxmox_test_connection()
proxmox_list_qemu(node="pve")

Tools

Tool	Description
`proxmox_connect` / `proxmox_use_target`	Multi-target registry (persisted)
`proxmox_test_connection`	Version + nodes
`proxmox_list_nodes`	Cluster nodes
`proxmox_list_qemu` / `proxmox_list_lxc`	Guest inventory
`proxmox_get_qemu_status` / `proxmox_get_lxc_status`	Live status
`proxmox_get_qemu_config`	VM config
`proxmox_lxc_exec` / `proxmox_qemu_agent_exec`	Guest exec (writes)
`proxmox_get_task_log`	Async task output

Golden target

Saved as golden-proxmox in ~/.local/share/proxmox-mcp/targets.json (add API token locally).

License

MIT

1.4 KiB Raw Blame History