English Français العربية

Proxmox VE

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • PROXMOX_HOST إلزامي 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 سري API token secret.
  • PROXMOX_PASSWORD سري 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 سري 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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • PROXMOX_HOST إلزامي 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 سري API token secret.
  • PROXMOX_PASSWORD سري 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 سري Optional: report tool traces and errors to Sentry. Unset disables it.

الأسئلة الشائعة

ما هو Proxmox VE؟

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

كيف أثبّت Proxmox VE؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Proxmox VE إلى مفتاح API؟

نعم. يتطلب PROXMOX_HOST, PROXMOX_TOKEN_VALUE, PROXMOX_PASSWORD, SENTRY_DSN، وتضبطها في إعداداته.

هل Proxmox VE مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Proxmox VE؟

ينشره akmalovaa. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.