mcp-server-proxmox
MCP server for Proxmox VE — exposes cluster, VMs, nodes, containers, storage, and access management as read-only MCP tools over HTTP.
Installation
pip install mcp-server-proxmox
Configuration
Create a .env file (or set environment variables):
PVE_HOST=192.168.1.100
PVE_PORT=8006
PVE_TOKEN_ID=root@pam!mcp
PVE_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
PVE_VERIFY_SSL=false
PORT=8000
PVE_TOKEN_ID format: user@realm!tokenname. Create the token in
Datacenter → Permissions → API Tokens in the Proxmox web UI.
Usage
mcp-server-proxmox
The server starts on http://0.0.0.0:8000 by default. Override the port with
the PORT environment variable.
Available tools
Cluster
| Tool | Description |
|---|---|
get_cluster_status |
Overall cluster health and quorum |
list_nodes |
All nodes in the cluster |
get_cluster_resources |
All resources (VMs, containers, storage) with optional type filter |
get_datacenter_config |
Datacenter-level configuration |
get_ha_status |
High Availability manager status |
Virtual Machines (QEMU/KVM)
| Tool | Description |
|---|---|
list_vms |
All VMs on a node with CPU/memory usage |
get_vm_status |
Runtime state, CPU, memory, disk and network I/O |
get_vm_config |
Hardware config: CPU, memory, disks, network interfaces |
Nodes
| Tool | Description |
|---|---|
get_node_status |
CPU, memory, disk, kernel, uptime |
get_node_dns |
DNS resolver configuration |
list_node_network |
Network interfaces and their settings |
list_node_storage |
Storage pools available on the node |
list_node_services |
System services and their states |
list_node_tasks |
Recent task log (configurable limit) |
Containers (LXC)
| Tool | Description |
|---|---|
list_containers |
All LXC containers on a node |
get_container_status |
Runtime state and resource usage |
get_container_config |
Container configuration |
Storage
| Tool | Description |
|---|---|
list_storage |
All storage definitions in the cluster |
list_storage_content |
Contents of a specific storage pool on a node |
Access
| Tool | Description |
|---|---|
list_users |
All Proxmox users |
list_acl |
Access control list entries |
Requirements
- Python 3.11+
- Proxmox VE 7.x or 8.x
1 maintainer
Metadata
1 maintainer
Release files for mcp-server-proxmox 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_server_proxmox-0.2.0.tar.gz | 92.2 kB | Without provenance | Details for mcp_server_proxmox-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_server_proxmox-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for mcp_server_proxmox-0.2.0-py3-none-any.whl |
Total release size: 100.2 kB
Release files / mcp_server_proxmox-0.2.0.tar.gz
| Download URL | mcp_server_proxmox-0.2.0.tar.gz |
|---|---|
| Size | 92.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ebe8ff553cb98d6d1565e535513273dd02629eb89d2d3672d73dc1ddda4359de
|
|
BLAKE2b-256 checksum How to use checksums |
bb6b67cfa0ef4bb636f45e60c48358bd2fcf67f4338486accd980a0f3d31823d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mcp_server_proxmox-0.2.0-py3-none-any.whl
| Download URL | mcp_server_proxmox-0.2.0-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d7edca07a937b7ecdddabac3cdfa4967d8d4fffc96f9f25f57a88de8f4260802
|
|
BLAKE2b-256 checksum How to use checksums |
97655f6db3f54689cbb9e2c28c295d555c4d1225ba5348f950671ddf5d748c93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for mcp-server-proxmox 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
