English Français العربية

Proxmox VE

Registre officiel Autres

Manage Proxmox VE nodes, VMs, containers, storage and snapshots. Read-only by default.

Code source Site web

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package proxmox-ve-mcp
Claude Code 
claude mcp add proxmox-ve -e 'PROXMOX_HOST=<PROXMOX_HOST>' -e 'PROXMOX_PORT=8006' -e 'PROXMOX_VERIFY_SSL=false' -e 'PROXMOX_TIMEOUT=15' -e 'PROXMOX_USER=root@pam' -e 'PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME>' -e 'PROXMOX_TOKEN_VALUE=<your proxmox_token_value>' -e 'PROXMOX_PASSWORD=<your proxmox_password>' -e 'PROXMOX_RISK_LEVEL=read' -e 'PROXMOX_TOOLS_ALLOW=<PROXMOX_TOOLS_ALLOW>' -e 'PROXMOX_REDACT_SECRETS=true' -e 'PROXMOX_MCP_TRANSPORT=stdio' -e 'PROXMOX_MCP_HOST=127.0.0.1' -e 'PROXMOX_MCP_PORT=8000' -e 'PROXMOX_MCP_PATH=/mcp' -e 'PROXMOX_MCP_JSON_RESPONSE=true' -e 'PROXMOX_MCP_ALLOWED_HOSTS=<PROXMOX_MCP_ALLOWED_HOSTS>' -e 'PROXMOX_MCP_ALLOWED_ORIGINS=<PROXMOX_MCP_ALLOWED_ORIGINS>' -e 'SENTRY_DSN=<your sentry_dsn>' -- uvx proxmox-ve-mcp==2.3.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "proxmox-ve": {
            "command": "uvx",
            "args": [
                "proxmox-ve-mcp==2.3.0"
            ],
            "env": {
                "PROXMOX_HOST": "<PROXMOX_HOST>",
                "PROXMOX_PORT": "8006",
                "PROXMOX_VERIFY_SSL": "false",
                "PROXMOX_TIMEOUT": "15",
                "PROXMOX_USER": "root@pam",
                "PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
                "PROXMOX_TOKEN_VALUE": "<your proxmox_token_value>",
                "PROXMOX_PASSWORD": "<your proxmox_password>",
                "PROXMOX_RISK_LEVEL": "read",
                "PROXMOX_TOOLS_ALLOW": "<PROXMOX_TOOLS_ALLOW>",
                "PROXMOX_REDACT_SECRETS": "true",
                "PROXMOX_MCP_TRANSPORT": "stdio",
                "PROXMOX_MCP_HOST": "127.0.0.1",
                "PROXMOX_MCP_PORT": "8000",
                "PROXMOX_MCP_PATH": "/mcp",
                "PROXMOX_MCP_JSON_RESPONSE": "true",
                "PROXMOX_MCP_ALLOWED_HOSTS": "<PROXMOX_MCP_ALLOWED_HOSTS>",
                "PROXMOX_MCP_ALLOWED_ORIGINS": "<PROXMOX_MCP_ALLOWED_ORIGINS>",
                "SENTRY_DSN": "<your sentry_dsn>"
            }
        }
    }
}

Variables d'environnement

  • PROXMOX_HOST obligatoire Proxmox host IP or hostname.
  • PROXMOX_PORT Proxmox API port.
  • PROXMOX_VERIFY_SSL Verify the TLS certificate. Proxmox self-signs by default.
  • PROXMOX_TIMEOUT Seconds to wait for each Proxmox API request.
  • PROXMOX_USER API user, including the realm.
  • PROXMOX_TOKEN_NAME API token name. Use this plus PROXMOX_TOKEN_VALUE, or PROXMOX_PASSWORD.
  • PROXMOX_TOKEN_VALUE secret API token secret.
  • PROXMOX_PASSWORD secret Password, used only when no API token is set.
  • PROXMOX_RISK_LEVEL Which tools exist: read-only, plus lifecycle, or everything.
  • PROXMOX_TOOLS_ALLOW Comma-separated tool names to register, intersected with the risk level. Unset = all of them.
  • PROXMOX_REDACT_SECRETS Mask cipassword and sshkeys in every response.
  • PROXMOX_MCP_TRANSPORT stdio (default) or streamable-http.
  • PROXMOX_MCP_HOST HTTP bind address. Anything but loopback also needs PROXMOX_MCP_ALLOWED_HOSTS.
  • PROXMOX_MCP_PORT HTTP port.
  • PROXMOX_MCP_PATH Streamable HTTP endpoint path.
  • PROXMOX_MCP_JSON_RESPONSE Answer with JSON instead of an SSE stream.
  • PROXMOX_MCP_ALLOWED_HOSTS Comma-separated Host headers to accept over HTTP; '*' disables the check.
  • PROXMOX_MCP_ALLOWED_ORIGINS Comma-separated browser origins allowed to call the endpoint. Empty = same-origin only.
  • SENTRY_DSN secret Optional: report tool traces and errors to Sentry. Unset disables it.
OCI package ghcr.io/akmalovaa/proxmox-mcp:2.3.0
Claude Code 
claude mcp add proxmox-ve -e 'PROXMOX_HOST=<PROXMOX_HOST>' -e 'PROXMOX_PORT=8006' -e 'PROXMOX_VERIFY_SSL=false' -e 'PROXMOX_TIMEOUT=15' -e 'PROXMOX_USER=root@pam' -e 'PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME>' -e 'PROXMOX_TOKEN_VALUE=<your proxmox_token_value>' -e 'PROXMOX_PASSWORD=<your proxmox_password>' -e 'PROXMOX_RISK_LEVEL=read' -e 'PROXMOX_TOOLS_ALLOW=<PROXMOX_TOOLS_ALLOW>' -e 'PROXMOX_REDACT_SECRETS=true' -e 'PROXMOX_MCP_TRANSPORT=stdio' -e 'PROXMOX_MCP_HOST=127.0.0.1' -e 'PROXMOX_MCP_PORT=8000' -e 'PROXMOX_MCP_PATH=/mcp' -e 'PROXMOX_MCP_JSON_RESPONSE=true' -e 'PROXMOX_MCP_ALLOWED_HOSTS=<PROXMOX_MCP_ALLOWED_HOSTS>' -e 'PROXMOX_MCP_ALLOWED_ORIGINS=<PROXMOX_MCP_ALLOWED_ORIGINS>' -e 'SENTRY_DSN=<your sentry_dsn>' -- docker run -i --rm ghcr.io/akmalovaa/proxmox-mcp:2.3.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "proxmox-ve": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/akmalovaa/proxmox-mcp:2.3.0"
            ],
            "env": {
                "PROXMOX_HOST": "<PROXMOX_HOST>",
                "PROXMOX_PORT": "8006",
                "PROXMOX_VERIFY_SSL": "false",
                "PROXMOX_TIMEOUT": "15",
                "PROXMOX_USER": "root@pam",
                "PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
                "PROXMOX_TOKEN_VALUE": "<your proxmox_token_value>",
                "PROXMOX_PASSWORD": "<your proxmox_password>",
                "PROXMOX_RISK_LEVEL": "read",
                "PROXMOX_TOOLS_ALLOW": "<PROXMOX_TOOLS_ALLOW>",
                "PROXMOX_REDACT_SECRETS": "true",
                "PROXMOX_MCP_TRANSPORT": "stdio",
                "PROXMOX_MCP_HOST": "127.0.0.1",
                "PROXMOX_MCP_PORT": "8000",
                "PROXMOX_MCP_PATH": "/mcp",
                "PROXMOX_MCP_JSON_RESPONSE": "true",
                "PROXMOX_MCP_ALLOWED_HOSTS": "<PROXMOX_MCP_ALLOWED_HOSTS>",
                "PROXMOX_MCP_ALLOWED_ORIGINS": "<PROXMOX_MCP_ALLOWED_ORIGINS>",
                "SENTRY_DSN": "<your sentry_dsn>"
            }
        }
    }
}

Variables d'environnement

  • PROXMOX_HOST obligatoire Proxmox host IP or hostname.
  • PROXMOX_PORT Proxmox API port.
  • PROXMOX_VERIFY_SSL Verify the TLS certificate. Proxmox self-signs by default.
  • PROXMOX_TIMEOUT Seconds to wait for each Proxmox API request.
  • PROXMOX_USER API user, including the realm.
  • PROXMOX_TOKEN_NAME API token name. Use this plus PROXMOX_TOKEN_VALUE, or PROXMOX_PASSWORD.
  • PROXMOX_TOKEN_VALUE secret API token secret.
  • PROXMOX_PASSWORD secret Password, used only when no API token is set.
  • PROXMOX_RISK_LEVEL Which tools exist: read-only, plus lifecycle, or everything.
  • PROXMOX_TOOLS_ALLOW Comma-separated tool names to register, intersected with the risk level. Unset = all of them.
  • PROXMOX_REDACT_SECRETS Mask cipassword and sshkeys in every response.
  • PROXMOX_MCP_TRANSPORT stdio (default) or streamable-http.
  • PROXMOX_MCP_HOST HTTP bind address. Anything but loopback also needs PROXMOX_MCP_ALLOWED_HOSTS.
  • PROXMOX_MCP_PORT HTTP port.
  • PROXMOX_MCP_PATH Streamable HTTP endpoint path.
  • PROXMOX_MCP_JSON_RESPONSE Answer with JSON instead of an SSE stream.
  • PROXMOX_MCP_ALLOWED_HOSTS Comma-separated Host headers to accept over HTTP; '*' disables the check.
  • PROXMOX_MCP_ALLOWED_ORIGINS Comma-separated browser origins allowed to call the endpoint. Empty = same-origin only.
  • SENTRY_DSN secret Optional: report tool traces and errors to Sentry. Unset disables it.

Questions fréquentes

Qu'est-ce que Proxmox VE ?

Manage Proxmox VE nodes, VMs, containers, storage and snapshots. Read-only by default.

Comment installer Proxmox VE ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add proxmox-ve -e 'PROXMOX_HOST=<PROXMOX_HOST>' -e 'PROXMOX_PORT=8006' -e 'PROXMOX_VERIFY_SSL=false' -e 'PROXMOX_TIMEOUT=15' -e 'PROXMOX_USER=root@pam' -e 'PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME>' -e 'PROXMOX_TOKEN_VALUE=<your proxmox_token_value>' -e 'PROXMOX_PASSWORD=<your proxmox_password>' -e 'PROXMOX_RISK_LEVEL=read' -e 'PROXMOX_TOOLS_ALLOW=<PROXMOX_TOOLS_ALLOW>' -e 'PROXMOX_REDACT_SECRETS=true' -e 'PROXMOX_MCP_TRANSPORT=stdio' -e 'PROXMOX_MCP_HOST=127.0.0.1' -e 'PROXMOX_MCP_PORT=8000' -e 'PROXMOX_MCP_PATH=/mcp' -e 'PROXMOX_MCP_JSON_RESPONSE=true' -e 'PROXMOX_MCP_ALLOWED_HOSTS=<PROXMOX_MCP_ALLOWED_HOSTS>' -e 'PROXMOX_MCP_ALLOWED_ORIGINS=<PROXMOX_MCP_ALLOWED_ORIGINS>' -e 'SENTRY_DSN=<your sentry_dsn>' -- uvx proxmox-ve-mcp==2.3.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Proxmox VE ?

Oui. Il attend PROXMOX_HOST, PROXMOX_TOKEN_VALUE, PROXMOX_PASSWORD, SENTRY_DSN, à renseigner dans sa configuration.

Proxmox VE est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Proxmox VE ?

Il est publié par akmalovaa. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.