ProxmoxMCP-Plus
MCP-сервер для Proxmox VE: управление виртуалками, LXC, снапшотами и бэкапами из агента с контролем прав и одобрением команд
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Управляет боевой виртуализацией: виртуалки, LXC, снапшоты, бэкапы
- Требует API-токен Proxmox с правами на изменения
- Нативный MCP по HTTP при неверной настройке можно открыть без авторизации
Установка
В терминале, через 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.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи 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-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Agent Skills для продуктов Google
Agent Skills for Google products and technologies
Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента
MCP-серверы для AWS
Open source MCP servers for AWS
Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг