ProxmoxMCP-Plus

MCP-сервер для Proxmox VE: управление виртуалками, LXC, снапшотами и бэкапами из агента с контролем прав и одобрением команд

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Управляет боевой виртуализацией: виртуалки, LXC, снапшоты, бэкапы
  • Требует API-токен Proxmox с правами на изменения
  • Нативный MCP по HTTP при неверной настройке можно открыть без авторизации
Все причины и проверки

rekklesna/proxmoxmcp-plus

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/proxmoxmcp-plus

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'PROXMOX_HOST=<значение PROXMOX_HOST>' --env 'PROXMOX_USER=<значение PROXMOX_USER>' --env 'PROXMOX_TOKEN_NAME=<значение PROXMOX_TOKEN_NAME>' --env 'PROXMOX_TOKEN_VALUE=<ваш PROXMOX_TOKEN_VALUE>' proxmox-mcp-plus -- uvx proxmox-mcp-plus==0.5.20

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"proxmox-mcp-plus","type":"stdio","command":"uvx","args":["proxmox-mcp-plus==0.5.20"],"env":{"PROXMOX_HOST":"<значение PROXMOX_HOST>","PROXMOX_USER":"<значение PROXMOX_USER>","PROXMOX_TOKEN_NAME":"<значение PROXMOX_TOKEN_NAME>","PROXMOX_TOKEN_VALUE":"<ваш PROXMOX_TOKEN_VALUE>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "proxmox-mcp-plus": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add proxmox-mcp-plus --env 'PROXMOX_HOST=<значение PROXMOX_HOST>' --env 'PROXMOX_USER=<значение PROXMOX_USER>' --env 'PROXMOX_TOKEN_NAME=<значение PROXMOX_TOKEN_NAME>' --env 'PROXMOX_TOKEN_VALUE=<ваш PROXMOX_TOKEN_VALUE>' -- uvx proxmox-mcp-plus==0.5.20

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.proxmox-mcp-plus]
command = "uvx"
args = ["proxmox-mcp-plus==0.5.20"]
env = { PROXMOX_HOST = "<значение PROXMOX_HOST>", PROXMOX_USER = "<значение PROXMOX_USER>", PROXMOX_TOKEN_NAME = "<значение PROXMOX_TOKEN_NAME>", PROXMOX_TOKEN_VALUE = "<ваш PROXMOX_TOKEN_VALUE>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'PROXMOX_HOST=<значение PROXMOX_HOST>' -e 'PROXMOX_USER=<значение PROXMOX_USER>' -e 'PROXMOX_TOKEN_NAME=<значение PROXMOX_TOKEN_NAME>' -e 'PROXMOX_TOKEN_VALUE=<ваш PROXMOX_TOKEN_VALUE>' proxmox-mcp-plus uvx proxmox-mcp-plus==0.5.20

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "proxmox-mcp-plus": {
      "type": "local",
      "command": [
        "uvx",
        "proxmox-mcp-plus==0.5.20"
      ],
      "environment": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus==0.5.20"
      ],
      "env": {
        "PROXMOX_HOST": "<значение PROXMOX_HOST>",
        "PROXMOX_USER": "<значение PROXMOX_USER>",
        "PROXMOX_TOKEN_NAME": "<значение PROXMOX_TOKEN_NAME>",
        "PROXMOX_TOKEN_VALUE": "<ваш PROXMOX_TOKEN_VALUE>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PROXMOX_MCP_CONFIGнеобязательная
Optional path to a JSON config file. If set, file config is used before environment variable fallback.
PROXMOX_HOSTобязательная
Hostname or IP address of the Proxmox VE API endpoint.
PROXMOX_USERобязательная
Proxmox username with realm, for example root@pam.
PROXMOX_TOKEN_NAMEобязательная
Name of the Proxmox API token.
PROXMOX_TOKEN_VALUEсекрет, обязательная
Secret value of the Proxmox API token.
PROXMOX_PORTнеобязательная
Proxmox API port. Defaults to 8006.
PROXMOX_VERIFY_SSLнеобязательная
Set to true to verify TLS certificates, or false for self-signed lab environments.
PROXMOX_DEV_MODEнеобязательная
Set to true when using verify_ssl=false in a self-signed lab environment.
PROXMOX_SERVICEнеобязательная
Proxmox service type. Defaults to PVE.
MCP_TOOL_ALLOWLISTнеобязательная
Optional comma-separated exact tool names to expose. Do not set together with MCP_TOOL_DENYLIST.
MCP_TOOL_DENYLISTнеобязательная
Optional comma-separated exact tool names to hide. Do not set together with MCP_TOOL_ALLOWLIST.
LOG_LEVELнеобязательная
Server log verbosity. Defaults to INFO.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит 97a004b.

Текст для агента

Установи uvx proxmox-mcp-plus и добавь сервер в конфигурацию MCP клиента. Заранее скопируй proxmox-config/config.example.json в config.json и пропиши адрес узла и API-токен Proxmox.

Другие способы из описания автора
uvx proxmox-mcp-plus

Запуск MCP stdio из PyPI без установки в систему. Нужен uv.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер связывает Proxmox VE с агентами и HTTP-инструментами через единый слой управления. Он покрывает повседневные операции: работу с виртуальными машинами и LXC, снапшоты, бэкапы, ISO, хранилища и запросы к узлам кластера. Долгие задачи отслеживаются по стабильным идентификаторам job_id с привязкой к Proxmox UPID, есть опрос статуса, повтор, отмена и история. Доступны два пути: нативный MCP для агентов и мост OpenAPI для дашбордов и no-code сценариев. Ставится через uvx или pip с PyPI, либо запускается в docker.

Для кого. Для devops-инженеров и владельцев homelab, которые держат виртуализацию на Proxmox VE.

Подходит, если

  • Нужно управлять виртуалками и LXC на Proxmox из агента
  • Нужны снапшоты, бэкапы и работа с хранилищами по запросу
  • Нужно отслеживать долгие задачи Proxmox с повтором и отменой

Не подходит, если

  • Нет API-токена Proxmox с нужными правами
  • Не хотите давать агенту доступ к боевой виртуализации
  • Нужен только просмотр без риска изменяющих операций

Пример запроса к агенту

Покажи узлы и виртуалки Proxmox и сделай снапшот vm 101 перед обновлением

Ограничения

Нужен доступ к Proxmox VE и API-токен, права токена определяют, что сервер сможет делать. Конфигурация задается в файле proxmox-config/config.json с адресом узла и токеном. Для нативного MCP по HTTP требуется отдельный ключ MCP_API_KEY и заголовок Authorization с каждым запросом, иначе доступ надо явно открыть небезопасной опцией. Сервер выполняет изменяющие операции над инфраструктурой.

Как отключить. Удалите запись сервера из конфигурации MCP клиента, остановите контейнер docker, если он запущен, и отзовите API-токен Proxmox.

MCP

Транспорт
stdio, http, sse
Авторизация
API-ключ
Переменные окружения
Переменные окружения
MCP_API_KEY
секрет
Ключ для доступа к нативному MCP по HTTP, передается в заголовке Authorization и не связан с учеткой Proxmox
PROXMOX_MCP_MODE
Режим запуска сервера, например mcp-http для нативного MCP по HTTP

Проверка безопасности

  • Управляет боевой виртуализацией: виртуалки, LXC, снапшоты, бэкапы
  • Требует API-токен Proxmox с правами на изменения
  • Нативный MCP по HTTP при неверной настройке можно открыть без авторизации

Коротко о README

README описывает управление Proxmox VE из MCP-клиентов, агентов и OpenAPI-инструментов с акцентом на безопасность: API-токены Proxmox, bearer-авторизация OpenAPI, политика команд, токены одобрения и проверка TLS. Показаны три пути запуска: MCP stdio через uvx proxmox-mcp-plus, нативный MCP по HTTP через docker compose и мост OpenAPI. Долгие операции отслеживаются по job_id и Proxmox UPID. Отдельно описан режим выполнения кода с тремя инструментами в изолированной песочнице. Лицензия MIT.

Частые вопросы

Чем нативный MCP отличается от OpenAPI?

Нативный MCP используют агенты. Мост OpenAPI дает те же операции по HTTP для дашбордов, скриптов и no-code инструментов.

Как настраивается доступ к Proxmox?

Через файл proxmox-config/config.json, где указывают адрес узла, порт и API-токен с нужными правами.

Выбор редакции

MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента

MCP-серверСредний рискБез VPN80,7 тыс.Звезды репозитория
Выбор редакции

Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента

MCP-серверВысокий риск33,3 тыс.Звезды репозитория

Agent Skills для продуктов Google

Agent Skills for Google products and technologies

Выбор редакции

Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента

СкиллВысокий риск20,5 тыс.Звезды репозитория

MCP-серверы для AWS

Open source MCP servers for AWS

Официальный

Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг

MCP-серверВысокий риск9,7 тыс.Звезды репозитория
Foxx AIProxmoxMCP-Plus

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.