MCP.so
Sign In

Proxmox MCP Server

@johnstetter

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

johnstetter

About Proxmox MCP Server

mcp server for interfacing with proxmox

Proxmox MCP Server config

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

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

Proxmox MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

What are the prerequisites?

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

3

How do I configure credentials?

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

4

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.

5

What endpoints does it expose?

`get_cluster_info`, `get_node_info`, `get_vm_info`, and `list_vms`.

Comments

More Other MCP servers