proxmox-mcp
npm
v0.1.1
Source verified
Published by joshuagreeff — publish provenance cryptographically ties this package to that repository. That is proof of origin, not an official vendor package.
stdio MCP server for operating Proxmox VE through typed tools plus explicit high-risk escape hatches.
The grade answers one question — how safe is this server for you to adopt — so it is computed in two auditable stages. Nothing below is an opinion or an LLM's guess; every line is a real term the deterministic engine applied, and the same input always yields the same number.
1. Threat score — 100 − 0 = 100. What the published surface and source actually contain:
The deterministic scan raised no scored threat in the surface it inspected — the threat score stayed at 100. Capability observations and advisory notes are recorded but never lower it.
2. Client adoption risk — 100 − 10 = 90. Three small, subtract-only factors that reflect your risk in adopting it — a clean scan proves less on a powerful, unverified or barely-inspectable package, so the grade says so plainly:
| Points | Adoption-risk factor |
|---|---|
| −10 | capability blast radius (critical) — client exposure if the model is manipulated |
Capability observations and info notes are shown under Findings but never scored.
Open any row's finding below for the file, line and evidence behind a deduction.
This server (without client built-ins) exposes a complete data-exfiltration chain: proxmox_storage_download_url → proxmox_vm_cloud_init_dump → proxmox_node_terminal_run. Untrusted input is ingested, private data is read, and it can be sent to an external sink via the agent composing the tools (→). Static analysis proves the primitive exists, not that a specific run will occur.
Fix: Remove one leg of the trifecta: isolate untrusted-input tools from secret-reading tools and from egress tools, or require human approval between them.
Location: flow proxmox_storage_download_url → proxmox_vm_cloud_init_dump → proxmox_node_terminal_run
Tool "proxmox_shell_run" appears to run shell commands or evaluate code (keyword "shell" in tool name, parameter "command"). Arbitrary execution driven by model input is one of the most dangerous MCP capabilities; combined with any untrusted input it becomes RCE.
Fix: Sandbox execution, allowlist commands/arguments, and never pass model output to a shell unescaped.
Location: tool proxmox_shell_run
Tool "proxmox_node_terminal_run" appears to run shell commands or evaluate code (parameter "command"). Arbitrary execution driven by model input is one of the most dangerous MCP capabilities; combined with any untrusted input it becomes RCE.
Fix: Sandbox execution, allowlist commands/arguments, and never pass model output to a shell unescaped.
Location: tool proxmox_node_terminal_run
Tool "proxmox_vm_guest_exec" appears to run shell commands or evaluate code (keyword "exec" in tool name, parameter "command"). Arbitrary execution driven by model input is one of the most dangerous MCP capabilities; combined with any untrusted input it becomes RCE.
Fix: Sandbox execution, allowlist commands/arguments, and never pass model output to a shell unescaped.
Location: tool proxmox_vm_guest_exec
In the server's implementation (`dist/schema.js:91`): Evaluating strings as code is the most direct RCE primitive; if any tool input reaches it, the server executes attacker-chosen code. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.
Evidence: t sandbox = {}; vm.runInNewContext(`${raw}\nthis.apiSchema = apiSchema;`, sandbox); const roots = sandbo
Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.
Location: server dist/schema.js
In the server's implementation (`dist/ssh.js:3`): Spawning a shell/process is command-execution capability; with unsanitized tool input it is command injection / RCE. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.
Evidence: rt { spawn } from "node:child_process"; import { Client } from "ssh2"; import { shellJoin } from "./utils.js"; /** Verif
Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.
Location: server dist/ssh.js
Tool "proxmox_storage_download_url" takes a URL/host parameter "url" with no allowlist/pattern. An outbound-request tool with an unbounded destination enables SSRF and cloud-metadata access (e.g. 169.254.169.254).
Fix: Allowlist destinations or constrain the parameter; block private/link-local addresses server-side.
Location: tool proxmox_storage_download_url · inputSchema.properties.url
Tool "proxmox_shell_run" takes a command-shaped parameter "command" with no enum/pattern constraint. Free-form, model- or attacker-controlled arguments reaching a shell is the command-injection precondition.
Fix: Constrain the parameter (enum/pattern), or build the command from a fixed template with escaped args.
Location: tool proxmox_shell_run · inputSchema.properties.command
Tool "proxmox_node_terminal_run" takes a command-shaped parameter "command" with no enum/pattern constraint. Free-form, model- or attacker-controlled arguments reaching a shell is the command-injection precondition.
Fix: Constrain the parameter (enum/pattern), or build the command from a fixed template with escaped args.
Location: tool proxmox_node_terminal_run · inputSchema.properties.command
Tool "proxmox_vm_guest_exec" takes a command-shaped parameter "command" with no enum/pattern constraint. Free-form, model- or attacker-controlled arguments reaching a shell is the command-injection precondition.
Fix: Constrain the parameter (enum/pattern), or build the command from a fixed template with escaped args.
Location: tool proxmox_vm_guest_exec · inputSchema.properties.command
Tool "proxmox_shell_run" can mutate/egress but declares no destructiveHint. Clients that don't default to spec-safe behavior may not prompt before running it.
Fix: Declare accurate annotations, and gate destructive tools on user confirmation regardless.
Location: tool proxmox_shell_run
Tool "proxmox_node_terminal_run" can mutate/egress but declares no destructiveHint. Clients that don't default to spec-safe behavior may not prompt before running it.
Fix: Declare accurate annotations, and gate destructive tools on user confirmation regardless.
Location: tool proxmox_node_terminal_run
Tool "proxmox_vm_guest_exec" can mutate/egress but declares no destructiveHint. Clients that don't default to spec-safe behavior may not prompt before running it.
Fix: Declare accurate annotations, and gate destructive tools on user confirmation regardless.
Location: tool proxmox_vm_guest_exec
Each tool and what it can reach — statically extracted from the published source.
proxmox_node_terminal_runruns code / shellproxmox_shell_runruns code / shellproxmox_storage_download_urlingests untrusted inputproxmox_vm_cloud_init_dumpreads sensitive dataproxmox_vm_guest_execruns code / shelljob_cancelno sensitive capabilityjob_getno sensitive capabilityjob_logsno sensitive capabilityjob_waitno sensitive capabilityproxmox_api_callno sensitive capabilityproxmox_backup_jobsno sensitive capabilityproxmox_backup_startno sensitive capabilityproxmox_bootstrap_node_accessno sensitive capabilityproxmox_capabilitiesno sensitive capabilityproxmox_ceph_statusno sensitive capabilityproxmox_cli_runno sensitive capabilityproxmox_cloud_init_snippet_deleteno sensitive capabilityproxmox_cloud_init_snippet_getno sensitive capabilityproxmox_cloud_init_snippet_listno sensitive capabilityproxmox_cloud_init_snippet_putno sensitive capabilityproxmox_cluster_statusno sensitive capabilityproxmox_console_ticketno sensitive capabilityproxmox_file_readno sensitive capabilityproxmox_file_writeno sensitive capabilityproxmox_firewall_getno sensitive capabilityproxmox_inventory_overviewno sensitive capabilityproxmox_lxc_actionno sensitive capabilityproxmox_lxc_getno sensitive capabilityproxmox_lxc_listno sensitive capabilityproxmox_network_listno sensitive capabilityproxmox_node_actionno sensitive capabilityproxmox_node_getno sensitive capabilityproxmox_node_listno sensitive capabilityproxmox_pci_mapping_createno sensitive capabilityproxmox_pci_mapping_deleteno sensitive capabilityproxmox_pci_mapping_getno sensitive capabilityproxmox_pci_mapping_listno sensitive capabilityproxmox_pci_mapping_updateno sensitive capabilityproxmox_sdn_listno sensitive capabilityproxmox_storage_getno sensitive capabilityproxmox_storage_listno sensitive capabilityproxmox_task_getno sensitive capabilityproxmox_task_listno sensitive capabilityproxmox_user_listno sensitive capabilityproxmox_vm_actionno sensitive capabilityproxmox_vm_agent_infono sensitive capabilityproxmox_vm_agent_pingno sensitive capabilityproxmox_vm_boot_diagnoseno sensitive capabilityproxmox_vm_cloneno sensitive capabilityproxmox_vm_convert_to_templateno sensitive capabilityproxmox_vm_createno sensitive capabilityproxmox_vm_destroyno sensitive capabilityproxmox_vm_getno sensitive capabilityproxmox_vm_guest_agent_diagnoseno sensitive capabilityproxmox_vm_listno sensitive capabilityproxmox_vm_template_getno sensitive capabilityproxmox_vm_template_listno sensitive capabilityproxmox_vm_update_configno sensitive capabilityCross-tool combinations that form a data-exfiltration primitive (untrusted input → sensitive source → external sink).
Scan history per published version. The engine is deterministic — the same version always yields the same score, so a changed score means the package itself changed.
| Version | Score | Findings | Engine | Scanned |
|---|---|---|---|---|
v0.1.1 latest |
A 90/100 | 13 | 1.13.0 | 2026-09-07 |
Show this server's live Trust Score in your README, docs or website. The badge is served straight from the registry and updates automatically after every rescan — no API key needed. It links back to this page, so anyone who sees the grade can also read the findings behind it instead of taking a number on faith.
The score above is reproducible: the same package version always yields the same result. Run it locally or over the free API — no account, no LLM, fully deterministic.
npx mcptrustchecker scan proxmox-mcp --online
Independent packages implementing the same tool, scanned with the same engine. Compare all 9 side by side →
MCP server exposing Proxmox VE management as tools over stdio
MCP server for Proxmox VE — read-only monitoring via PVE REST API
MCP server for Proxmox VE and Proxmox Datacenter Manager — every API endpoint behind catalog-backed list/describe/call tools, reads live, writes ENV-gated.
MCP server for managing Proxmox VE infrastructure
Proxmox VE operator CLI with a gated MCP adapter
MCP server for Proxmox VE infrastructure management
Operator control CLI for AdGuard Home with an MCP adapter
interacting with Aliyun (Alibaba Cloud) services through This MCP server provides tools.
MCP server for the Aspro.Cloud REST API
MCP server for Atlassian Confluence and Jira Cloud APIs
AuroraCloud-first MCP server that exposes AuroraDocs workspace data to Claude Desktop and other AI agents
The official AWS Knowledge Base retrieval server using Bedrock Agent Runtime.