Proxmox Mcp

What is Proxmox Mcp?

An MCP server for managing Proxmox VE. It exposes 38 tools covering nodes, QEMU VMs, LXC containers, storage, cluster, and snapshots. Designed for LLM agents to interact with a Proxmox environment via natural language.

How to use Proxmox Mcp?

Run the server as a single Docker container: docker run ghcr.io/akmalovaa/proxmox-mcp:latest. Pass authentication as environment variables (PROXMOX_HOST, PROXMOX_USER, plus password or token). Add an entry to your Claude configuration (claude_desktop_config.json or ~/.claude/settings.json) to register the MCP server.

Key features of Proxmox Mcp

• Single multi-arch Docker image (amd64 + arm64)
• Configuration via environment variables only, no files or database
• Read-only by default; destructive operations require an explicit risk level
• Tiny codebase: pure stdio MCP over the Proxmoxer library
• Raw JSON output, no formatting or emoji, optimized for LLM consumption

Use cases of Proxmox Mcp

• Manage VMs and LXC containers through conversational AI
• Query node, storage, and cluster status from Proxmox
• Automate snapshot creation and management across resources
• Perform safe, read-only Proxmox inspections with default risk settings

FAQ from Proxmox Mcp

How do I authenticate to Proxmox?

Set PROXMOX_HOST and PROXMOX_USER, plus either PROXMOX_PASSWORD or the recommended token pair PROXMOX_TOKEN_NAME and PROXMOX_TOKEN_VALUE.

Is the server read-only by default?

Yes. Destructive operations are gated behind an explicit PROXMOX_RISK_LEVEL environment variable that must be set to a higher level.

What runtime is required?

Only Docker. The image is multi-arch and supports amd64 and arm64 hosts.

How do I configure it with Claude?

Add a proxmox entry under mcpServers in your Claude configuration file, using the Docker command and passing the required environment variables.

What format does the output use?

Raw JSON. The server returns clean data without formatting, emoji, or extra commentary, making it easy for an LLM to parse.