Proxmox MCP Server

Name: Proxmox MCP Server
Author: johnstetter

@johnstetter

Repository

About Proxmox MCP Server

mcp server for interfacing with proxmox

#mcp-proxmox #proxmox #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-proxmox": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

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 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.