Proxmox Virtualization Control
Enhanced MCP server for managing Proxmox virtualization platforms with complete VM lifecycle management, LXC container support, and OpenAPI integration. Enables natural language VM creation, power management, and comprehensive cluster monitoring thro
What is Proxmox Virtualization Control?
Proxmox Virtualization Control is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enhanced mcp server for managing proxmox virtualization platforms with complete vm lifecycle management, lxc container support, and openapi integration. enables natural language vm creation, power man...
Enhanced MCP server for managing Proxmox virtualization platforms with complete VM lifecycle management, LXC container support, and OpenAPI integration. Enables natural language VM creation, power management, and comprehensive cluster monitoring thro
This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enhanced MCP server for managing Proxmox virtualization plat
Use Cases
Maintainer
Works with
Installation
PIP
pip install proxmox-mcp-plusManual Installation
pip install proxmox-mcp-plusConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Proxmox Virtualization Control
ProxmoxMCP-Plus is an enhanced Python MCP server for managing Proxmox VE virtualization clusters, providing full VM and LXC container lifecycle management — create, start, stop, snapshot, backup, restore, and delete — through natural language via Claude or other MCP clients. It supports multiple deployment modes including stdio for Claude Desktop, an OpenAPI HTTP bridge for Open WebUI, and a streamable HTTP transport for remote agents. Homelab operators and DevOps engineers can use it to provision and monitor their Proxmox infrastructure conversationally without touching the Proxmox web UI or writing API scripts.
Prerequisites
- A running Proxmox VE cluster (version 7.x or 8.x) accessible over the network
- A Proxmox API token (created in Proxmox UI under Datacenter > Permissions > API Tokens) with appropriate permissions
- Python 3.11+ and either pip or uv/uvx installed, OR Docker for containerized deployment
- A proxmox-config/config.json file with your Proxmox connection details
- Claude Desktop or another MCP client for stdio mode
Create the Proxmox API token
In the Proxmox web UI, go to Datacenter > Permissions > API Tokens and create a token for a user with sufficient privileges. Note the token name and secret value — the secret is only shown once.
Create the configuration file
Create a proxmox-config/config.json file in your working directory with your Proxmox connection details. Replace all placeholder values with your real credentials.
mkdir -p proxmox-config
cat > proxmox-config/config.json << 'EOF'
{
"proxmox": {
"host": "192.168.1.100",
"port": 8006
},
"auth": {
"user": "root@pam",
"token_name": "mytoken",
"token_value": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
}
EOFInstall the package
Install proxmox-mcp-plus from PyPI, or use uvx to run it without a permanent installation.
pip install proxmox-mcp-plus
# or run directly without installing:
uvx proxmox-mcp-plusConfigure Claude Desktop
Add the server block to your claude_desktop_config.json, pointing PROXMOX_MCP_CONFIG to the absolute path of your config.json file.
Restart Claude Desktop and verify
Restart Claude Desktop and ask it to list your Proxmox nodes to confirm connectivity.
Optionally deploy via Docker for OpenAPI or HTTP mode
For Open WebUI or remote agent access, run the Docker image in OpenAPI bridge mode on port 8811.
docker run --rm -p 8811:8811 \
-e PROXMOX_API_KEY="$(openssl rand -hex 32)" \
-v "$(pwd)/proxmox-config/config.json:/app/proxmox-config/config.json:ro" \
ghcr.io/rekklesna/proxmoxmcp-plus:latestProxmox Virtualization Control Examples
Client configuration
Add this to your claude_desktop_config.json for stdio mode. Set PROXMOX_MCP_CONFIG to the absolute path of your config.json file.
{
"mcpServers": {
"proxmox": {
"command": "proxmox-mcp-plus",
"args": [],
"env": {
"PROXMOX_MCP_CONFIG": "/absolute/path/to/proxmox-config/config.json",
"PROXMOX_VERIFY_SSL": "false"
}
}
}
}Prompts to try
Use these natural language prompts in Claude Desktop to manage your Proxmox cluster.
- "List all nodes in my Proxmox cluster and show their CPU and memory usage"
- "Create a new Ubuntu 22.04 VM with 2 cores, 4GB RAM, and 50GB disk on node pve1"
- "Take a snapshot of VM 101 called 'before-upgrade'"
- "List all LXC containers and show which ones are stopped"
- "Show the available storage pools and their free space"
- "Start VM 105 and wait for it to come online"Troubleshooting Proxmox Virtualization Control
Authentication error: 401 Unauthorized when connecting to Proxmox
Verify auth.user matches the exact format used in Proxmox (e.g., 'root@pam' or 'admin@pve'). Confirm auth.token_name is the token identifier (not the full string) and auth.token_value is the secret UUID shown when the token was created.
SSL certificate verification error for self-signed Proxmox certificates
Set PROXMOX_VERIFY_SSL=false in the env block of your MCP config or in config.json. Proxmox uses a self-signed certificate by default, so this is expected in homelab environments.
VM creation or power commands fail with permission errors
The API token's role must include VM.Allocate, VM.PowerMgmt, and Datastore.AllocateSpace privileges. In Proxmox, assign the 'Administrator' role to the token for full access, or create a custom role with the required permissions.
Frequently Asked Questions about Proxmox Virtualization Control
What is Proxmox Virtualization Control?
Proxmox Virtualization Control is a Model Context Protocol (MCP) server that enhanced mcp server for managing proxmox virtualization platforms with complete vm lifecycle management, lxc container support, and openapi integration. enables natural language vm creation, power management, and comprehensive cluster monitoring thro It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Proxmox Virtualization Control?
Install via pip with: pip install proxmox-mcp-plus. Then configure your AI client to connect to this MCP server.
Which AI clients work with Proxmox Virtualization Control?
Proxmox Virtualization Control works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Proxmox Virtualization Control free to use?
Yes, Proxmox Virtualization Control is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Proxmox Virtualization Control Alternatives — Similar Cloud Services Servers
Looking for alternatives to Proxmox Virtualization Control? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Proxmox Virtualization Control in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Proxmox Virtualization Control?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.