Proxmox Mcp Plus

Name: Proxmox Mcp Plus
Author: RekklesNA

by RekklesNAcommunityv0.4.7

182

An MCP and OpenAPI server for controlling Proxmox VE workflows, including VM and LXC lifecycle actions, snapshots, backups, ISO management, and container command execution. It also tracks asynchronous Proxmox tasks with persistent job IDs and exposes job control endpoints.

From the registry: Proxmox VE MCP server for VMs, LXCs, snapshots, backups, storage, and cluster operations.

GitHub Repository Website

Install & configure

Prerequisites

optional
Install Python package runner or package
Install a Python runtime and use the published PyPI package. The README prefers the PyPI path via uvx, with pip install also supported.
```
$ uvx proxmox-mcp-plus
```
https://pypi.org/project/proxmox-mcp-plus/
required
Create Proxmox MCP configuration file
Create a config file from the provided example and fill in your Proxmox connection and authentication settings. At minimum, the config needs proxmox.host, proxmox.port, auth.user, auth.token_name, and auth.token_value. Add ssh settings if you want container command execution, and jobs settings if you want job persistence somewhere other than the default local SQLite file.
```
$ cp proxmox-config/config.example.json proxmox-config/config.json
```

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `proxmox-mcp-plus` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Create Proxmox MCP configuration file** — Create a config file from the provided example and fill in your Proxmox connection and authentication settings. At minimum, the config needs proxmox.host, proxmox.port, auth.user, auth.token_name, and auth.token_value. Add ssh settings if you want container command execution, and jobs settings if you want job persistence somewhere other than the default local SQLite file. Run: `cp proxmox-config/config.example.json proxmox-config/config.json`

Optional prerequisites:
- Install Python package runner or package — Install a Python runtime and use the published PyPI package. The README prefers the PyPI path via uvx, with pip install also supported. Run: `uvx proxmox-mcp-plus` (https://pypi.org/project/proxmox-mcp-plus/)

Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["proxmox-mcp-plus"]
- required environment variables:
  - `PROXMOX_MCP_CONFIG`: Path to the ProxmoxMCP-Plus JSON configuration file containing Proxmox host, port, auth token details, and optional ssh/jobs settings. (example: `<path-to-proxmox-config.json>`)

Note: The README's MCP example runs the server via local source using python main.py, but the simpler portable path is the published PyPI package via uvx. The server also exposes an HTTP/OpenAPI surface for separate deployment, but the MCP client configuration shown is stdio-based. Default job persistence uses a local SQLite file if not otherwise configured in the JSON config.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: The README's MCP example runs the server via local source using python main.py, but the simpler portable path is the published PyPI package via uvx. The server also exposes an HTTP/OpenAPI surface for separate deployment, but the MCP client configuration shown is stdio-based. Default job persistence uses a local SQLite file if not otherwise configured in the JSON config.