Proxmox (JoshuaGreeff) MCP Server

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.

Trust grade
A
90/100
Last scanned get badge →
Trust
A · 90/100
Adoption risk for you: the threat score, then adjusted down for blast radius, publisher verification and how much the scan could see. Deterministic; every point is auditable.
Capability
Critical
Blast radius if it went rogue — what the server’s tools could reach. Independent of trust.
Coverage
Source
How much the scan could actually inspect. Shallow coverage is stated, never hidden.
Share this Trust Score
𝕏 Share LinkedIn Reddit
A Why this grade threat 100 − adoption risk = 90/100

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:

PointsAdoption-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.

Findings 13

critical Completed toxic-flow trifecta across toolsMTC-FLOW-002

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

high Tool "proxmox_shell_run" exposes command/code executionMTC-CAP-001

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

high Tool "proxmox_node_terminal_run" exposes command/code executionMTC-CAP-001

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

high Tool "proxmox_vm_guest_exec" exposes command/code executionMTC-CAP-001

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

high Dynamic code execution in server code (dist/schema.js)MTC-SRC-001

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

high Shell/command execution in server code (dist/ssh.js)MTC-SRC-002

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

medium Unconstrained URL/host parameter "url" on "proxmox_storage_download_url"MTC-CAP-007

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

medium Unconstrained command parameter "command" on "proxmox_shell_run"MTC-CAP-006

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

medium Unconstrained command parameter "command" on "proxmox_node_terminal_run"MTC-CAP-006

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

medium Unconstrained command parameter "command" on "proxmox_vm_guest_exec"MTC-CAP-006

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

low Mutating tool "proxmox_shell_run" declares no destructiveHintMTC-CAP-005

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

low Mutating tool "proxmox_node_terminal_run" declares no destructiveHintMTC-CAP-005

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

low Mutating tool "proxmox_vm_guest_exec" declares no destructiveHintMTC-CAP-005

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

Tools 58

Each tool and what it can reach — statically extracted from the published source.

  • proxmox_node_terminal_runruns code / shell
  • proxmox_shell_runruns code / shell
  • proxmox_storage_download_urlingests untrusted input
  • proxmox_vm_cloud_init_dumpreads sensitive data
  • proxmox_vm_guest_execruns code / shell
  • job_cancelno sensitive capability
  • job_getno sensitive capability
  • job_logsno sensitive capability
  • job_waitno sensitive capability
  • proxmox_api_callno sensitive capability
Show 48 more tools ↓
  • proxmox_backup_jobsno sensitive capability
  • proxmox_backup_startno sensitive capability
  • proxmox_bootstrap_node_accessno sensitive capability
  • proxmox_capabilitiesno sensitive capability
  • proxmox_ceph_statusno sensitive capability
  • proxmox_cli_runno sensitive capability
  • proxmox_cloud_init_snippet_deleteno sensitive capability
  • proxmox_cloud_init_snippet_getno sensitive capability
  • proxmox_cloud_init_snippet_listno sensitive capability
  • proxmox_cloud_init_snippet_putno sensitive capability
  • proxmox_cluster_statusno sensitive capability
  • proxmox_console_ticketno sensitive capability
  • proxmox_file_readno sensitive capability
  • proxmox_file_writeno sensitive capability
  • proxmox_firewall_getno sensitive capability
  • proxmox_inventory_overviewno sensitive capability
  • proxmox_lxc_actionno sensitive capability
  • proxmox_lxc_getno sensitive capability
  • proxmox_lxc_listno sensitive capability
  • proxmox_network_listno sensitive capability
  • proxmox_node_actionno sensitive capability
  • proxmox_node_getno sensitive capability
  • proxmox_node_listno sensitive capability
  • proxmox_pci_mapping_createno sensitive capability
  • proxmox_pci_mapping_deleteno sensitive capability
  • proxmox_pci_mapping_getno sensitive capability
  • proxmox_pci_mapping_listno sensitive capability
  • proxmox_pci_mapping_updateno sensitive capability
  • proxmox_sdn_listno sensitive capability
  • proxmox_storage_getno sensitive capability
  • proxmox_storage_listno sensitive capability
  • proxmox_task_getno sensitive capability
  • proxmox_task_listno sensitive capability
  • proxmox_user_listno sensitive capability
  • proxmox_vm_actionno sensitive capability
  • proxmox_vm_agent_infono sensitive capability
  • proxmox_vm_agent_pingno sensitive capability
  • proxmox_vm_boot_diagnoseno sensitive capability
  • proxmox_vm_cloneno sensitive capability
  • proxmox_vm_convert_to_templateno sensitive capability
  • proxmox_vm_createno sensitive capability
  • proxmox_vm_destroyno sensitive capability
  • proxmox_vm_getno sensitive capability
  • proxmox_vm_guest_agent_diagnoseno sensitive capability
  • proxmox_vm_listno sensitive capability
  • proxmox_vm_template_getno sensitive capability
  • proxmox_vm_template_listno sensitive capability
  • proxmox_vm_update_configno sensitive capability

Toxic flows 1

Cross-tool combinations that form a data-exfiltration primitive (untrusted input → sensitive source → external sink).

What this scan could not see

Versions 1

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.

VersionScoreFindingsEngineScanned
v0.1.1 latest A 90/100 13 1.13.0 2026-09-07

Embed this score

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.

MCP Trust Score: A · 90/100
Markdown (GitHub README)
[![MCP Trust Score](https://mcptrustchecker.com/registry/proxmox-mcp-2/badge.svg)](https://mcptrustchecker.com/registry/proxmox-mcp-2)
HTML
<a href="https://mcptrustchecker.com/registry/proxmox-mcp-2"><img src="https://mcptrustchecker.com/registry/proxmox-mcp-2/badge.svg" alt="MCP Trust Score" height="20"></a>
Prefer shields.io styling? Point it at https://mcptrustchecker.com/registry/proxmox-mcp-2/badge.json via https://img.shields.io/endpoint?url=…

Verify this score yourself

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

Use the free API → How scoring works

Other implementations of Proxmox 8

Independent packages implementing the same tool, scanned with the same engine. Compare all 9 side by side →

More in Cloud & DevOps