Server data from the Official MCP Registry
Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.
Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.
Valid MCP server (1 strong, 1 medium validity signals). 7 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
7 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: PROXMOX_HOST
Environment variable: PROXMOX_USER
Environment variable: PROXMOX_TOKEN_NAME
Environment variable: PROXMOX_TOKEN_VALUE
Environment variable: PROXMOX_PORT
Environment variable: PROXMOX_VERIFY_SSL
Environment variable: PROXMOX_SERVICE
Environment variable: LOG_LEVEL
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-rekklesna-proxmox-mcp-plus": {
"env": {
"LOG_LEVEL": "your-log-level-here",
"PROXMOX_HOST": "your-proxmox-host-here",
"PROXMOX_PORT": "your-proxmox-port-here",
"PROXMOX_USER": "your-proxmox-user-here",
"PROXMOX_SERVICE": "your-proxmox-service-here",
"PROXMOX_TOKEN_NAME": "your-proxmox-token-name-here",
"PROXMOX_VERIFY_SSL": "your-proxmox-verify-ssl-here",
"PROXMOX_TOKEN_VALUE": "your-proxmox-token-value-here"
},
"args": [
"proxmox-mcp-plus"
],
"command": "uvx"
}
}
}From the project's GitHub README.
ProxmoxMCP-Plus provides a unified Proxmox VE control surface in two forms:
MCP for Claude Desktop, Open WebUI, and other LLM or AI agent clientsOpenAPI for HTTP automation, dashboards, internal tools, and no-code workflowsInstead of stitching together raw Proxmox API calls, shell scripts, and custom glue code, the project consolidates core operational workflows in one interface:
ProxmoxMCP-Plus is designed for the gap between low-level Proxmox primitives and production-facing workflows that need to be usable from both LLM-native clients and standard automation systems.
Dual-surface architecture: MCP for conversational workflows, OpenAPI for standard automationOperator-oriented scope: focused on day-2 tasks, not just raw low-level endpointsSafer-by-default execution: auth, command policy, and explicit execution pathsOperationally grounded: documented workflows are backed by live-environment verificationRead the official Proxmox docs first if you are setting up a fresh lab:
At minimum, proxmox-config/config.json needs:
proxmox.hostproxmox.portauth.userauth.token_nameauth.token_valueAdd an ssh section as well if you want container command execution.
uvx proxmox-mcp-plus
Or install it first:
pip install proxmox-mcp-plus
proxmox-mcp-plus
docker run --rm -p 8811:8811 \
-v "$(pwd)/proxmox-config/config.json:/app/proxmox-config/config.json:ro" \
ghcr.io/rekklesna/proxmoxmcp-plus:latest
git clone https://github.com/RekklesNA/ProxmoxMCP-Plus.git
cd ProxmoxMCP-Plus
uv venv
uv pip install -e ".[dev]"
python main.py
docker compose up -d
curl -f http://localhost:8811/health
curl http://localhost:8811/openapi.json
Minimal MCP client shape:
{
"mcpServers": {
"proxmox-mcp-plus": {
"command": "python",
"args": ["/path/to/ProxmoxMCP-Plus/main.py"],
"env": {
"PROXMOX_MCP_CONFIG": "/path/to/ProxmoxMCP-Plus/proxmox-config/config.json"
}
}
}
}
Client-specific examples for Claude Desktop and Open WebUI are in the Integrations Guide.
This demo is a direct terminal recording of qwen/qwen3.6-plus driving a live MCP session in English against a local Proxmox lab. It shows natural-language control flowing through MCP tools to create and start an LXC, execute a container command, and confirm the HTTP /health surface.

ProxmoxMCP-Plus provides a unified control surface for the operational tasks most teams actually need in Proxmox VE. The same server can expose these workflows to MCP clients for LLM and AI-agent use cases, and to HTTP consumers through the OpenAPI bridge.
Supported workflow areas:
| Capability Area | Availability |
|---|---|
| VM create / start / stop / delete | Available |
| VM snapshot create / rollback / delete | Available |
| Backup create / restore | Available |
| ISO download / delete | Available |
| LXC create / start / stop / delete | Available |
| Container SSH-backed command execution | Available |
| Container authorized_keys update | Available |
Local OpenAPI /health and schema | Available |
Docker image build and /health | Available |
Validation and contract entry points in this repository:
pytest -qtests/integration/test_real_contract.pytest_scripts/run_real_e2e.py| Capability | Official Proxmox API | One-off scripts | ProxmoxMCP-Plus |
|---|---|---|---|
| MCP for LLM and AI agent workflows | No | No | Yes |
| OpenAPI surface for standard HTTP tooling | No | Usually no | Yes |
| VM and LXC operations in one interface | Low-level only | Depends | Yes |
| Snapshot, backup, and restore workflows | Low-level only | Depends | Yes |
| Container command execution with policy controls | No | Custom only | Yes |
| Docker distribution path | No | Rare | Yes |
| Repository-level live-environment verification | N/A | Rare | Yes |
Ready-to-copy examples live in examples/:
These are written for both human operators and LLM-driven usage.
The README is intentionally optimized for fast GitHub comprehension. Longer operational docs live in docs/wiki/ and can also be published to the GitHub Wiki.
| If you need to... | Start here |
|---|---|
| Understand the project and deployment flow | Wiki Home |
| Configure and run against a Proxmox environment | Operator Guide |
| Connect Claude Desktop or Open WebUI | Integrations Guide |
| Review security and command policy | Security Guide |
| Inspect tool parameters, prerequisites, and behavior | API & Tool Reference |
| Debug startup, auth, or health issues | Troubleshooting |
| Work on the codebase or release it | Developer Guide |
| Review release and upgrade notes | Release & Upgrade Notes |
Published wiki:
src/proxmox_mcp/: MCP server, config loading, security, OpenAPI bridgemain.py: MCP entrypoint for local and client-driven usagedocker-compose.yml: HTTP/OpenAPI runtimerequirements/: auxiliary dependency sources and runtime install listsscripts/: helper startup scripts for local workflowstest_scripts/run_real_e2e.py: live Proxmox and Docker/OpenAPI pathtests/: unit and integration coverageexamples/: scenario-driven prompts and HTTP examplesdocs/wiki/: longer-form operator, integration, and reference docspytest -q
ruff check .
mypy src tests main.py test_scripts/run_real_e2e.py
python -m build
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.