Proxmox Mcp
@akmalovaa
About Proxmox Mcp
Minimal Proxmox VE MCP server for Claude — 38 tools, one Docker command, read-only by default
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"proxmox": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROXMOX_HOST",
"-e",
"PROXMOX_USER",
"-e",
"PROXMOX_PASSWORD",
"ghcr.io/akmalovaa/proxmox-mcp:latest"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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.
Frequently asked questions
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.
Basic information
More Other MCP servers
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
ICSS
chokcoco不止于 CSS
Comments