# ProxmoxMCP-Plus

> Enhanced Proxmox MCP server with advanced virtualization management and full OpenAPI integration.

- **URL**: https://www.freshcrate.ai/projects/ProxmoxMCP-Plus
- **Author**: RekklesNA
- **Category**: MCP Servers
- **Latest version**: `v0.5.8` (2026-06-07)
- **License**: MIT
- **Source**: https://github.com/RekklesNA/ProxmoxMCP-Plus
- **Language**: Python
- **GitHub**: 139 stars, 42 forks
- **Registry**: github
- **Tags**: `python`

## Description

Enhanced Proxmox MCP server with advanced virtualization management and full OpenAPI integration.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.5.8` | 2026-06-07 | High | # ProxmoxMCP-Plus v0.5.8  Release date: 2026-06-07  ## Windows SSH Compatibility Fixes (Issue #100)  This release fixes four critical bugs that prevented `execute_container_command` and `get_node_status` from working correctly on Windows 11 with Claude Code (VS Code extension). All bugs are also observable on any platform that runs the MCP server headless without a TTY.  ### Bug 1 - SSH command never includes the username  - **File:** `src/proxmox_mcp/tools/console/container_manager.py |
| `v0.5.7` | 2026-05-30 | High | # ProxmoxMCP-Plus v0.5.7  Release date: 2026-05-30  ## Visual Documentation Improvements  - Replaced the README hero architecture diagram with a new publication-style SVG. - The new diagram is grounded in the actual project architecture:   - MCP stdio clients   - MCP Streamable HTTP at `/mcp`   - OpenAPI automation through `/docs`, `/openapi.json`, `/health`, `/readyz`, and `/metrics`   - FastMCP server boundary   - OpenAPI proxy   - built-in tool registry and domain tool plugins   - command pol |
| `v0.5.3` | 2026-05-27 | High | # ProxmoxMCP-Plus v0.5.3  Release date: 2026-05-27  ## Fixes  - `manifest.json` now declares all 42 tools registered at runtime, including job, VM config, container config, container IP, container command, and SSH key tools. - VM and LXC command execution logs no longer record command text, command output, or command error content by default. - OpenSSH-based LXC command execution and API SSH tunnel debug logs no longer expose full command lines or local key/known-hosts paths. - Error logging now |
| `v0.5.2` | 2026-05-12 | High | # ProxmoxMCP-Plus v0.5.2  Release date: 2026-05-12  ## Fixes  - `retry_job` now claims a retry with an atomic SQLite status transition before replaying the operation, preventing concurrent retry requests from duplicating high-risk work. - `cancel_job` now discards stale cancel results when the backing UPID changes while the cancellation request is in flight. - `setup.py` now matches the project metadata and requires `paramiko>=5.0.0,<6.0.0`. - `update_container_ssh_keys` is now classified as a h |
| `v0.4.9` | 2026-05-09 | High | # ProxmoxMCP-Plus v0.4.9  This release supersedes v0.4.8 with the same production reliability work plus a CodeQL-blocking log-injection fix.  ## What Changed  - Sanitized high-risk retry audit log values before writing them to logs, preventing forged log lines from job IDs or persisted tool names. - Kept the v0.4.8 reliability hardening:   - SQLite `JobStore` WAL, busy timeout, migration tracking, indexes, SQL filtering/limits, and explicit close lifecycle.   - Policy checks for high-risk job re |
| `v0.4.6` | 2026-05-02 | High | # ProxmoxMCP-Plus v0.4.6  Released: 2026-05-02  ## Fixes  - Makes `api_tunnel` effective by connecting Proxmox API calls to the configured local tunnel endpoint when the tunnel is enabled. - Refreshes persisted job records from SQLite before job reads and controls so OpenAPI `/jobs` can see jobs created by the MCP subprocess after proxy startup. - Prevents LXC creation secrets from being persisted in SQLite retry recipes when `password` or `ssh_public_keys` are provided. - Stops `rollba |
| `v0.4.4` | 2026-04-28 | High | # ProxmoxMCP-Plus v0.4.4  Release date: 2026-04-28  ## Summary  This maintenance release updates GitHub Actions workflow dependencies to current Node 24-compatible major versions.  ## Changes  - Updated checkout and Python setup actions used by CI and release workflows. - Updated artifact upload/download actions used by the PyPI publishing workflow. - Updated Docker login, metadata, and build/push actions used by the GHCR   publishing workflow.  ## Upgrade Notes  - No runtime or config migratio |
| `v0.4.1` | 2026-04-25 | High | # ProxmoxMCP-Plus v0.4.1  ## Highlights  - Fixed MCP client examples so their default TLS settings pass startup validation. - Added `PROXMOX_DEV_MODE` to Claude Desktop, manifest, and OpenCode examples. - Cleaned up duplicated long-running job documentation in the README. - Fixed the stale `test_scripts/run_real_e2e.py` path in the README. - Added an explicit Quick Start step to copy `config.example.json` to `config.json`.  ## Upgrade Notes  - No runtime configuration migration is required. - If |
| `v0.2.1` | 2026-04-18 | High | ## Why this release matters  `v0.2.1` turns the project's MCP Registry path into a repeatable release workflow instead of a one-off manual step.  This release is aimed at making discovery and installation more reliable across GitHub Copilot and other MCP Registry consumers.  ## User-visible highlights  - added `server.json` metadata for MCP Registry publication - added PyPI README ownership marker required for registry verification - aligned the published CLI entrypoint with the PyPI package nam |
| `v0.2.0` | 2026-04-18 | High | ## Why this release matters  `v0.2.0` makes the project easier to trust, easier to run, and easier to explain.  This release is aimed at LLM, AI agent, homelab, and self-hosted users who want one Proxmox control plane for both `MCP` and `OpenAPI`.  ## User-visible highlights  - real Proxmox live E2E coverage for VM, LXC, snapshot, backup, restore, ISO, SSH, OpenAPI, and Docker flows - source-vs-installed-package test isolation fix so `pytest` runs against the repository `src` tree - container SS |

## Dependency audit

- **Score**: 81/100
- **Total deps**: 13
- **Resolved**: 3
- **Unresolved**: 10
- **License conflicts**: 0
- **Warnings**: 2
- **Scanned**: 2026-05-04

## Citation

- HTML: https://www.freshcrate.ai/projects/ProxmoxMCP-Plus
- Markdown: https://www.freshcrate.ai/projects/ProxmoxMCP-Plus.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/ProxmoxMCP-Plus/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._