MCP server for Proxmox VE — remote streamable HTTP
Project description
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_server_proxmox-0.2.0.tar.gz.
File metadata
- Download URL: mcp_server_proxmox-0.2.0.tar.gz
- Upload date:
- Size: 92.2 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ebe8ff553cb98d6d1565e535513273dd02629eb89d2d3672d73dc1ddda4359de
|
|
| MD5 |
193e3db9b67b842ffa689cc6256af8d9
|
|
| BLAKE2b-256 |
bb6b67cfa0ef4bb636f45e60c48358bd2fcf67f4338486accd980a0f3d31823d
|
File details
Details for the file mcp_server_proxmox-0.2.0-py3-none-any.whl.
File metadata
- Download URL: mcp_server_proxmox-0.2.0-py3-none-any.whl
- Upload date:
- Size: 7.9 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7edca07a937b7ecdddabac3cdfa4967d8d4fffc96f9f25f57a88de8f4260802
|
|
| MD5 |
b707c8da1435ccd5ff54cefcf9b80bf7
|
|
| BLAKE2b-256 |
97655f6db3f54689cbb9e2c28c295d555c4d1225ba5348f950671ddf5d748c93
|
