{"_id":"@aidalinfo/proxmox-mcp","_rev":"2-fc6cfd2020026fae87f6f75d18975cf8","name":"@aidalinfo/proxmox-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aidalinfo/proxmox-mcp","version":"1.0.0","keywords":["mcp","mcp-server","proxmox","pve","virtualization","qemu","lxc","typescript"],"author":{"name":"Killian Stein / Aidalinfo"},"license":"MIT","_id":"@aidalinfo/proxmox-mcp@1.0.0","maintainers":[{"name":"aidalinfo","email":"dev@pulsemyit.fr"}],"homepage":"https://github.com/aidalinfo/cloud-mcp#readme","bugs":{"url":"https://github.com/aidalinfo/cloud-mcp/issues"},"bin":{"proxmox-mcp":"dist/index.js"},"dist":{"shasum":"4604fa097fe9e465eabc371c9c4f510c0f3cbeef","tarball":"https://registry.npmjs.org/@aidalinfo/proxmox-mcp/-/proxmox-mcp-1.0.0.tgz","fileCount":16,"integrity":"sha512-tAbufe6I3KOrMwzFZ0ew7MA53Z7vp/NAbrVkXteDTr94dh9vtIpyc+a8I8Pfqp9q0xnv1SM+YD5CZ4FEnSmw8w==","signatures":[{"sig":"MEYCIQCWghi6Xgei+mqNHkrC+P90owEnIXFXvvG2Yq/ZW99argIhAL0qmG4ezBZVNSeE170KL0IleYSlacq6BWTRcsQEIz3q","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29565},"main":"dist/index.js","type":"module","engines":{"node":">=20"},"gitHead":"2bc64f2a3d91ecb49cb33b7100d5899e5dd9abab","scripts":{"test":"NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests","build":"tsc","start":"node dist/index.js","prepack":"npm run build"},"_npmUser":{"name":"aidalinfo","email":"dev@pulsemyit.fr"},"repository":{"url":"git+https://github.com/aidalinfo/cloud-mcp.git","type":"git","directory":"packages/proxmox-mcp"},"_npmVersion":"10.9.8","description":"Proxmox VE MCP server with read-only / full-access modes — cluster, nodes, QEMU VMs, LXC, storage, backups, tasks","directories":{},"_nodeVersion":"22.22.3","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.27.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.3.0","ts-jest":"^29.4.6","typescript":"^5.7.0","@types/node":"^22.0.0","@jest/globals":"^30.3.0"},"_npmOperationalInternal":{"tmp":"tmp/proxmox-mcp_1.0.0_1781123200561_0.6327272992087309","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aidalinfo/proxmox-mcp","version":"1.0.1","description":"Proxmox VE MCP server with read-only / full-access modes — cluster, nodes, QEMU VMs, LXC, storage, backups, tasks","type":"module","main":"dist/index.js","bin":{"proxmox-mcp":"dist/index.js"},"publishConfig":{"access":"public"},"license":"MIT","author":{"name":"Killian Stein / Aidalinfo"},"repository":{"type":"git","url":"git+https://github.com/aidalinfo/cloud-mcp.git","directory":"packages/proxmox-mcp"},"engines":{"node":">=20"},"keywords":["mcp","mcp-server","proxmox","pve","virtualization","qemu","lxc","typescript"],"scripts":{"build":"tsc","prepack":"npm run build","start":"node dist/index.js","test":"NODE_OPTIONS=--experimental-vm-modules jest --passWithNoTests"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.0","zod":"^4.4.3"},"devDependencies":{"@jest/globals":"^30.3.0","@types/node":"^22.0.0","jest":"^30.3.0","ts-jest":"^29.4.6","typescript":"^5.7.0"},"_id":"@aidalinfo/proxmox-mcp@1.0.1","gitHead":"516f51b876e35950de7d916eb20abce92756700a","bugs":{"url":"https://github.com/aidalinfo/cloud-mcp/issues"},"homepage":"https://github.com/aidalinfo/cloud-mcp#readme","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-puG1ODeSXv56DTq2dKBfpQYxWM7AcMr2e0Ik0F+4HyVxG7NDYxu4E9f0iivj0L93WflippGd0TrBnfIN8bKYsg==","shasum":"b94681c1091315632732ce949a4003090f2ab85f","tarball":"https://registry.npmjs.org/@aidalinfo/proxmox-mcp/-/proxmox-mcp-1.0.1.tgz","fileCount":16,"unpackedSize":29595,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEMCH1hbt77hDnC+GpXDaPOnsjwTNwjZDkltBbkze+J6v8cCIBjSX3tgY8FruQpvM1f5svm6y7LZiXXJ4fcfcP50gVxq"}]},"_npmUser":{"name":"aidalinfo","email":"dev@pulsemyit.fr"},"directories":{},"maintainers":[{"name":"aidalinfo","email":"dev@pulsemyit.fr"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/proxmox-mcp_1.0.1_1781123753173_0.35467824504542755"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-10T20:26:40.365Z","modified":"2026-06-10T20:35:53.464Z","1.0.0":"2026-06-10T20:26:40.702Z","1.0.1":"2026-06-10T20:35:53.305Z"},"bugs":{"url":"https://github.com/aidalinfo/cloud-mcp/issues"},"author":{"name":"Killian Stein / Aidalinfo"},"license":"MIT","homepage":"https://github.com/aidalinfo/cloud-mcp#readme","keywords":["mcp","mcp-server","proxmox","pve","virtualization","qemu","lxc","typescript"],"repository":{"type":"git","url":"git+https://github.com/aidalinfo/cloud-mcp.git","directory":"packages/proxmox-mcp"},"description":"Proxmox VE MCP server with read-only / full-access modes — cluster, nodes, QEMU VMs, LXC, storage, backups, tasks","maintainers":[{"name":"aidalinfo","email":"dev@pulsemyit.fr"}],"readme":"# @aidalinfo/proxmox-mcp\n\nMCP server for a Proxmox VE cluster, with two modes:\n\n- **`readonly`** (default) — only read tools are exposed.\n- **`full`** — read tools **plus** write tools (VM/LXC lifecycle, snapshots, migrate).\n\nIn `readonly` mode the write tools are never registered, so the model cannot call them.\n\n## Tools\n\n**Read (both modes):** `pve_version`, `pve_cluster_status`, `pve_cluster_resources`,\n`pve_nodes`, `pve_node_info`, `pve_vms`, `pve_vm_info`, `pve_containers`,\n`pve_container_info`, `pve_storage`, `pve_storage_content`, `pve_tasks`, `pve_raw_get`.\n\n**Write (`full` only):** `pve_vm_action`, `pve_lxc_action`, `pve_snapshot_create`,\n`pve_snapshot_delete`, `pve_snapshot_rollback`, `pve_migrate`.\n\n## Environment\n\n| Var | Required | Default | Role |\n|---|---|---|---|\n| `PROXMOX_HOST` | yes | — | e.g. `https://proxmox.example.com:8006` |\n| `PROXMOX_TOKEN_ID` | yes | — | e.g. `claude@pve!readonly` |\n| `PROXMOX_TOKEN_SECRET` | yes | — | token secret |\n| `PROXMOX_MODE` | no | `readonly` | `readonly` \\| `full` |\n| `PROXMOX_TLS_INSECURE` | no | `false` | `true` to skip TLS verification (self-signed certs) |\n\n## Register with Claude Code\n\n```bash\nclaude mcp add proxmox --scope user \\\n  -e PROXMOX_HOST=https://proxmox.example.com:8006 \\\n  -e PROXMOX_TOKEN_ID='claude@pve!readonly' \\\n  -e PROXMOX_TOKEN_SECRET=... \\\n  -e PROXMOX_MODE=readonly \\\n  -e PROXMOX_TLS_INSECURE=true \\\n  -- npx -y @aidalinfo/proxmox-mcp\n```\n\nFor read-only use, create a token with the **PVEAuditor** role rather than `root@pam`.\n","readmeFilename":"README.md"}