Skip to content

Releases: mattoddie/proxmox-mcp

Release list

v0.1.0

Choose a tag to compare

@mattoddie mattoddie released this 11 Oct 15:43
07a3207

Added

  • MCP server for Proxmox VE with 314 tools in 19 toolsets: cluster, nodes, vms, containers, agent, snapshots, storage, backup, tasks, access, firewall, ha, sdn, ceph, pools, replication, notifications, hardware and raw.
  • Eight built-in prompts: cluster_health_check, troubleshoot_guest, capacity_planning, backup_audit, security_review, update_review, snapshot_cleanup and deploy_vm.
  • Authentication with an API token (PROXMOX_TOKEN_ID and PROXMOX_TOKEN_SECRET, or PROXMOX_API_TOKEN) or a username and password, with automatic ticket renewal.
  • Guests addressed by VMID, with the node looked up automatically, and PROXMOX_DEFAULT_NODE for node-scoped tools in a cluster.
  • Task handling: tools wait for Proxmox tasks (PROXMOX_TASK_TIMEOUT_MS) and report the result with the end of the task log, or return the UPID with wait: false.
  • Four access levels: read-only by default, PROXMOX_ALLOW_WRITES, PROXMOX_ALLOW_DELETES and PROXMOX_ALLOW_EXEC (guest agent commands and file access, QEMU monitor). PROXMOX_TOOLSETS limits the tools exposed. Secrets are redacted from output.
  • Streamable HTTP (stateless) and stdio transports, with bearer-token auth and a Host header allow-list for HTTP.
  • TLS verification options for Proxmox (PROXMOX_VERIFY_SSL, PROXMOX_CA_FILE).
  • _FILE variants of every variable for Docker secrets.
  • Multi-arch Docker image (linux/amd64, linux/arm64) published to GHCR on each release, with SBOM and provenance attestation.
  • Documentation, including a tool reference generated from the code.

Container image

docker pull ghcr.io/mattoddie/proxmox-mcp:0.1.0

Platforms: linux/amd64, linux/arm64 · Digest: sha256:82939e36fe4198aaa7594dd3fb948bf8c11e117d217dd83678057578b6e1bddc

Tags: 0.1, 0.1.0, latest