SSyncDev

Cursor Proxmox MCP Server

Manage Proxmox VE via Cursor: QEMU, LXC, storage, HA, firewall, access.

Local serverstdioPython

What is the Cursor Proxmox MCP Server?

Manage Proxmox VE via Cursor: QEMU, LXC, storage, HA, firewall, access.

The short version

Registered via tools/register.py (called from ProxmoxMCPServer._setup_tools()) — inventory locked by tools/inventory.py / tests/expected_tools.py (CI fails on drift).

  • Token auth via proxmoxer (JSON config + optional ${ENV} secret interpolation)
  • Structured tool_call audit logging (redacted) + verbose / env log overrides
  • Full guest lifecycle, snapshots, vzdump backups
  • Storage content + definition CRUD + URL download
  • Cluster HA, firewall (rules/aliases/ipsets), access/ACL/tokens
  • Replication jobs, SDN write + apply, ACME order/renew, Ceph status/pools, pools

What it needs from you

  • uv (recommended) or Python 3.10+ - Proxmox API token

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Cursor Proxmox MCP Server

{
  "mcpServers": {
    "proxmox": {
      "command": "python",
      "args": ["-m", "proxmox_mcp.server"],
      "cwd": "C:/Users/YOU/Projects/cursor-proxmox-mcp",
      "env": {
        "PROXMOX_MCP_CONFIG": "C:/Users/YOU/Projects/cursor-proxmox-mcp/proxmox-config/config.json",
        "PYTHONPATH": "C:/Users/YOU/Projects/cursor-proxmox-mcp/src"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • uv (recommended) or Python 3.10+ - Proxmox API token
VariableDescriptionRequired
PROXMOX_MCP_CONFIGConfiguration value read at startup.Optional
PYTHONPATHPython module search path for a local installation.Optional
PROXMOX_HOSTEndpoint or connection string the server talks to.Optional

Example prompts to try

  • “Use Cursor Proxmox MCP to Domain.”
  • “Use Cursor Proxmox MCP to Nodes.”
  • “Use Cursor Proxmox MCP to QEMU.”

Frequently asked questions

Manage Proxmox VE via Cursor: QEMU, LXC, storage, HA, firewall, access. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Cursor Proxmox MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Google Drive

Official

Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.

File Systems & StorageTypeScript★ 63.0k

SQLite

Official

Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.

DatabasesPython★ 63.0k

Fonoster

Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.

AI & ML ServicesTypeScript★ 8.1k

Obsidian

Chat with your second brain — search, read and write vault notes through the Local REST API.

Knowledge & MemoryPython★ 2.2k

Proxmox Manager

Manage Proxmox hypervisors through a Model Context Protocol server, providing a clean interface for nodes, VMs, and containers.

Knowledge & MemoryPython★ 284