Skip to content

Setup

Jump to bottom
wiki-sync edited this page Jul 19, 2026 · 3 revisions

Setup

Full first-run guide: SETUP.md in the repo.

Cursor mcp.json (recommended)

{
  "mcpServers": {
    "proxmox": {
      "command": "uvx",
      "args": ["--from", "C:/Users/YOU/Projects/cursor-proxmox-mcp", "cursor-proxmox-mcp"],
      "env": {
        "PROXMOX_MCP_CONFIG": "C:/Users/YOU/Projects/cursor-proxmox-mcp/proxmox-config/config.json"
      }
    }
  }
}

Prefer only PROXMOX_MCP_CONFIG (tokens in the JSON file / ${ENV} interpolation). Do not put token secrets in committed files.

After git pull — reload checklist

  1. Settings → MCP → Disable proxmox → Enable.
  2. Confirm tool count ~152. If still ~13–14 tools, fully quit Cursor and reopen (stale catalog).
  3. Avoid bare uvx proxmox-mcp-server — that installs a different PyPI project.
  4. Smoke: get_nodes, get_version, get_containers.

Auth / Privilege Separation

Proxmox tokens default to privsep=Yes: ACL must be on user@realm!tokenid. Empty lists often mean missing token ACL — use get_token_permissions.

cursor-proxmox-mcp — living guide for the Cursor ↔ Proxmox VE MCP connector

GitHub · v1.2.0 · Releases · CHANGELOG · Issues · PyPI

Source of truth: docs/wiki/ on main · Tools catalog: python scripts/generate-wiki-tools.py · Sync: scripts/sync-wiki.ps1 / scripts/sync-wiki.sh

cursor-proxmox-mcp

Repo

Clone this wiki locally