# rust-proxmoxmcp

> rust-proxmoxmcp is an open-source MCP server for cloud and infrastructure. Proxmox VE access across many clusters, with deletes held behind plan, approve and apply. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Website:** https://mechub.org/projects/rustproxmoxmcp/
- **Repository:** https://github.com/mechubsec/rustproxmoxmcp
- **MCP Registry name:** io.github.mechubsec/rustproxmoxmcp
- **Categories:** cloud and infrastructure, security
- **Listing updated:** 2026-11-16

## About

The server resolves each guest's node on every call, because guests migrate, so one endpoint can serve several clusters. It is written in Rust and runs over stdio from a container image, an LXC install or a release tarball.

Change control is the core design. Destructive work goes through plan, approve and apply: the approval binds the plan digest and the stored preview, and apply re-checks the guest's fingerprint and refuses one that moved. Delete and restore actions are authorization scopes reached through `plan_proxmox_destroy`, not separate tools.

There is deliberately no `grant_waiver` tool and no `force` argument. Waivers come from a service-owned file and lift protection only, never the second approver. The README says arbitrary command execution inside guests is not shipped until a policy engine can govern it. It is an unofficial community project.

## Features

- **Many clusters, one endpoint:** Guest nodes are resolved on each call so migrations do not break requests.
- **Plan, approve, apply:** Destructive changes need an approval bound to the exact preview shown.
- **Fingerprint re-check:** Apply refuses a guest whose fingerprint changed since the plan.
- **Time-boxed waivers:** Protection overrides come from a service-owned file with an expiry.
- **Pinned CA per cluster:** Certificates are pinned per cluster, with no skip-verify option.
- **Audit logging:** Structured logs with optional HMAC-keyed redaction.

## Good for

- Let an assistant inspect VMs and containers across clusters
- Require a second person to approve a VM deletion
- Keep protected guests from being changed by accident
- Audit what an automation did to a lab environment

## Install

### Claude Code (Terminal)

```sh
claude mcp add rustproxmoxmcp -- docker run -i --rm ghcr.io/mechubsec/rustproxmoxmcp:0.12.3
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rustproxmoxmcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustproxmoxmcp:0.12.3"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rustproxmoxmcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustproxmoxmcp:0.12.3"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rustproxmoxmcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustproxmoxmcp:0.12.3"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rustproxmoxmcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustproxmoxmcp:0.12.3"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rustproxmoxmcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/mechubsec/rustproxmoxmcp:0.12.3"
      ]
    }
  }
}
```

## Tools

- `plan_proxmox_destroy`: Plans a destructive action such as deleting a VM and records a preview for approval.
- `apply_proxmox_change_set`: The single entry point that applies an approved destructive change set.

## FAQ

### How many tools does it expose?

The README counts 51 callable tools in one version and the site says 50; most are read tools.

### Can an agent force a delete?

No. There is no force argument; destructive scopes go through plan_proxmox_destroy and approval.

### Is it affiliated with Proxmox?

No. The README calls it an unofficial community project.

### How is it installed?

As an OCI image, an LXC install script on Debian 13, or a Linux amd64 release tarball.

### Is rust-proxmoxmcp free?

Yes. rust-proxmoxmcp is open source, so you can use and self-host it for free.

### How do I add rust-proxmoxmcp to Claude Code?

Run this command in your terminal: claude mcp add rustproxmoxmcp -- docker run -i --rm ghcr.io/mechubsec/rustproxmoxmcp:0.12.3

### What are the best alternatives to rust-proxmoxmcp?

The closest alternatives to rust-proxmoxmcp are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/rust-proxmoxmcp
