Proxmox MCP Server

What is Proxmox MCP Server?

Proxmox MCP Server is a Model Context Protocol server that interfaces with a Proxmox VE server to provide infrastructure context to LLMs. It exposes endpoints that allow LLMs to query information about the Proxmox cluster, nodes, and virtual machines.

How to use Proxmox MCP Server?

Clone the repository, copy .env.example to .env, and update with your Proxmox host, user (e.g., user@pam), password, and SSL verification setting. Run with Docker Compose (docker-compose up --build) or locally with uvicorn src.main:app --reload after installing dependencies.

Key features of Proxmox MCP Server

• Get cluster-wide information
• Query specific node details
• Get VM information and status
• List all VMs in the cluster
• Docker and Docker Compose support for easy deployment
• Secure credential management through environment variables

Use cases of Proxmox MCP Server

• Provide LLM-based assistants with real-time Proxmox cluster context
• Retrieve detailed information about a specific Proxmox node
• Inquire into a specific VM’s status and configuration
• List all virtual machines across the cluster

FAQ from Proxmox MCP Server

What does Proxmox MCP Server do?

It is an MCP server that interfaces with a Proxmox VE server to give LLMs access to cluster, node, and VM information.

What are the prerequisites?

Python 3.11 or higher, Docker and Docker Compose, access to a Proxmox VE server, and Proxmox API credentials.

How do I configure credentials?

Copy .env.example to .env and set PROXMOX_HOST, PROXMOX_USER, PROXMOX_PASSWORD, and PROXMOX_VERIFY_SSL (typically false).

How do I run the server?

Build and start with docker-compose up --build; the server is then available at http://localhost:8008. For local development, use uvicorn src.main:app --reload after setting up a virtual environment and installing dependencies.

What endpoints does it expose?

get_cluster_info, get_node_info, get_vm_info, and list_vms.