Mcp Proxmox

io.github.felhen-ai由 GitHub 帳號 felhen-ai 發布v1.2.4更新於 Nov 4, 2026

Manage Proxmox VE clusters through AI assistants — VMs, containers, and more

已驗證STDIO僅桌面雲端與基礎設施安全與監控

服務詳細資訊

識別碼: io.github.felhen-ai/mcp-proxmox
傳輸: STDIO
執行環境: Desktop only
信任: Verified
發布於: Nov 4, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此條目所屬的 GitHub 帳號 felhen-ai。這並不表明該帳號就是產品方。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.felhen-ai%2Fmcp-proxmox.svg)](https://sourceweft.com/mcp/io.github.felhen-ai%2Fmcp-proxmox?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

讓 AI 助理管理 Proxmox VE 叢集：檢視節點、虛擬機與容器，控制電源、快照、備份、儲存、防火牆與遷移。

可以做什麼: 檢視節點、虛擬機、容器、儲存、網路、任務與資源指標
啟動、停止、關機、重新開機、擴充、複製、遷移與刪除虛擬機或容器
建立虛擬機與 LXC 容器、把虛擬機轉為範本、設定 cloud-init
建立、回復與刪除快照；建立、列出與還原備份
透過 guest agent 在 QEMU 虛擬機內執行指令，並擷取虛擬機主控台畫面或送出按鍵與文字
在虛擬機、節點或叢集層級列出、新增與刪除防火牆規則
適用情境: 適合自架或小型叢集的維運人員，用自然語言取代網頁介面查詢與操作 Proxmox VE，例如查看虛擬機狀態、升級前建立快照或新建虛擬機。
執行需求: 以本機 Python 套件執行（uvx 或 pip），需要能連線 Proxmox VE 主機，並設定環境變數 PROXMOX_HOST、PROXMOX_TOKEN_ID 與 PROXMOX_TOKEN_SECRET；可選 PROXMOX_PORT 與 PROXMOX_VERIFY_SSL。API 權杖需具備對應的 Proxmox 權限。exec_command 需要虛擬機內安裝並執行 qemu-guest-agent。

安裝前請注意

此權杖可實際控制叢集；取消「權限分離」即取得完整權限。許多工具會變更或銷毀資料：停止、重新開機、刪除、回復、還原、磁碟擴充（不可逆）、轉為範本與修改防火牆。破壞性工具需在警告後以 confirm=true 二次確認，但助理仍可能確認。PROXMOX_VERIFY_SSL 預設關閉，不驗證 TLS 憑證。主控台文字輸入與 cloud-init 可能夾帶憑證。

安裝

在 SourceWeft 中

開啟儀表板中的 Mcp Proxmox，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照儲存庫中的啟動說明。

README

mcp-proxmox

[mcp-proxmox MCP server]

MCP server for managing Proxmox VE clusters through AI assistants like Claude, Cursor, and Cline.

Provision, manage, and monitor your entire Proxmox infrastructure through natural language. Create VMs and containers, manage snapshots, browse storage, and more.

Quick Start

bash

# Run directly with uvx (no install needed)uvx mcp-proxmox
# Or install with pippip install mcp-proxmox

# Run directly with uvx (no install needed)uvx mcp-proxmox
# Or install with pippip install mcp-proxmox

Configuration

Set these environment variables (or create a .env file):

bash

PROXMOX_HOST=192.168.1.100          # Your Proxmox VE hostPROXMOX_TOKEN_ID=user@pam!mcp       # API token IDPROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  # API token secret

PROXMOX_HOST=192.168.1.100          # Your Proxmox VE hostPROXMOX_TOKEN_ID=user@pam!mcp       # API token IDPROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  # API token secret

Optional:

bash

PROXMOX_PORT=8006                   # Default: 8006PROXMOX_VERIFY_SSL=false            # Default: false

PROXMOX_PORT=8006                   # Default: 8006PROXMOX_VERIFY_SSL=false            # Default: false

Creating a Proxmox API Token

Log into your Proxmox web UI
Go to Datacenter > Permissions > API Tokens
Click Add and create a token for your user
Uncheck "Privilege Separation" for full access, or assign specific permissions:
- VM.Audit — read VM/CT status and config
- VM.PowerMgmt — start/stop/shutdown/reboot
- VM.Snapshot — create/rollback/delete snapshots
- VM.Allocate — create/delete/clone VMs and containers
- VM.Clone — clone operations
- Datastore.Audit — list storages and browse content
- Datastore.AllocateSpace — allocate disk space for new VMs/CTs
- Sys.Audit — read node status and tasks
- VM.Config.Disk — resize disks
- VM.Config.CPU — change CPU allocation
- VM.Config.Memory — change memory allocation
- VM.Monitor — access QEMU monitor (for metrics)
- VM.Console — console interaction tools (screenshots, keyboard input)
- VM.Migrate — migrate VMs/CTs between nodes
- Sys.Modify — manage firewall rules
- VM.Config.Cloudinit — configure cloud-init parameters

Integration

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

json

{  "mcpServers": {    "proxmox": {      "command": "uvx",      "args": ["mcp-proxmox"],      "env": {        "PROXMOX_HOST": "192.168.1.100",        "PROXMOX_TOKEN_ID": "user@pam!mcp",        "PROXMOX_TOKEN_SECRET": "your-token-secret"      }    }  }}

{  "mcpServers": {    "proxmox": {      "command": "uvx",      "args": ["mcp-proxmox"],      "env": {        "PROXMOX_HOST": "192.168.1.100",        "PROXMOX_TOKEN_ID": "user@pam!mcp",        "PROXMOX_TOKEN_SECRET": "your-token-secret"      }    }  }}

Claude Code

Add to .claude/settings.json or ~/.claude/settings.json:

json

{  "mcpServers": {    "proxmox": {      "command": "uvx",      "args": ["mcp-proxmox"],      "env": {        "PROXMOX_HOST": "192.168.1.100",        "PROXMOX_TOKEN_ID": "user@pam!mcp",        "PROXMOX_TOKEN_SECRET": "your-token-secret"      }    }  }}

{  "mcpServers": {    "proxmox": {      "command": "uvx",      "args": ["mcp-proxmox"],      "env": {        "PROXMOX_HOST": "192.168.1.100",        "PROXMOX_TOKEN_ID": "user@pam!mcp",        "PROXMOX_TOKEN_SECRET": "your-token-secret"      }    }  }}

Cursor

Add to Cursor Settings > MCP with the same configuration as above.

Available Tools

Discovery

Tool	Description
`list_nodes`	List all cluster nodes with CPU, memory, and uptime
`get_node_status`	Detailed node info: CPU model, memory, disk, versions
`list_vms`	List QEMU VMs (filter by node or status)
`list_containers`	List LXC containers (filter by node or status)
`get_guest_status`	Detailed VM/CT status by VMID (auto-detects type and node)

Lifecycle

Storage

Provisioning

Tool	Description
`create_vm`	Create a QEMU VM with configurable CPU, memory, disk, ISO, and network
`create_container`	Create an LXC container from a template
`clone_guest`	Clone a VM or CT (full or linked clone, cross-node support)
`delete_guest`	Permanently delete a stopped VM or CT (requires confirmation)

Backup & Restore

Tool	Description
`list_backups`	List backup files (filter by node, storage, or VMID)
`create_backup`	Create a vzdump backup (snapshot/suspend/stop modes, zstd/lzo/gzip)
`restore_backup`	Restore a VM or CT from a backup file (requires confirmation)

Command Execution

Note: exec_command requires qemu-guest-agent installed and running inside the VM. Not supported for LXC containers (Proxmox API limitation).

Console Interaction

Tool	Description
`vm_screenshot`	Capture a PNG screenshot of a QEMU VM's display (login prompt, boot messages, installer, GUI)
`vm_send_key`	Send a key or combination to a VM console (requires confirmation)
`vm_send_text`	Type ASCII text into a VM console (US layout; requires confirmation)

Note: Console tools do not require qemu-guest-agent and need only the VM.Console privilege. vm_screenshot opens the same VNC websocket tunnel the Proxmox web UI uses (RFB 3.8 with DES-based VNC auth) and is implemented in pure stdlib (custom WebSocket client + DES). Only QEMU VMs are supported. Text entry is layout-dependent: vm_send_text maps ASCII to a US keyboard layout (Shift-mapping for uppercase and symbols); non-ASCII input (e.g. Cyrillic) is not supported by the sendkey protocol.

Snapshots

Tool	Description
`list_snapshots`	List all snapshots for a VM/CT
`create_snapshot`	Create a new snapshot
`rollback_snapshot`	Rollback to a snapshot (requires confirmation)
`delete_snapshot`	Delete a snapshot (requires confirmation)

Network

Resize

Monitoring

Firewall

Tool	Description
`list_firewall_rules`	List firewall rules for a VM/CT, node, or the cluster
`add_firewall_rule`	Add a firewall rule (action, direction, protocol, port, source/dest)
`delete_firewall_rule`	Delete a firewall rule by position (requires confirmation)

Migration

Templates & Cloud-init

Tool	Description
`list_templates`	List all VM templates available for cloning
`create_template`	Convert a stopped VM into a template (requires confirmation, irreversible)
`configure_cloud_init`	Set user, password, SSH keys, IP config, and DNS on a VM

Safety

Destructive operations (stop_guest, reboot_guest, rollback_snapshot, delete_snapshot, delete_guest, resize_guest, restore_backup, delete_firewall_rule, migrate_guest, create_template) require explicit confirm=true. The first call returns a warning describing the impact; only a second call with confirmation executes the action.

Examples

Once connected, you can ask your AI assistant:

"List all my VMs and their status"
"How much memory is VM 100 using?"
"Shut down container 105"
"Create a snapshot of VM 200 called before-upgrade"
"Show me the CPU usage of VM 100 over the last day"
"What tasks ran on node pve recently?"
"Which VMs are stopped?"
"What storage pools do I have and how full are they?"
"Show me available ISO images"
"Create a new Ubuntu VM with 4 cores and 8GB RAM"
"Clone VM 100 as a test environment"
"Create a Debian container from template"
"Delete the old test VM 999"
"Back up VM 100 to the zfs-backup-storage"
"Show me all backups for VM 200"
"Restore the latest backup of container 101"
"Run 'df -h' on VM 100"
"Check if nginx is running on VM 200"
"Take a screenshot of VM 100 so I can see the console"
"The VM is stuck at a login prompt — type 'root' and press Enter"
"Show me the network bridges on node pve"
"Give VM 100 more CPU — bump it to 8 cores"
"Add 50GB of disk to container 101"
"Show me the firewall rules on VM 100"
"Allow TCP port 443 on container 101"
"Migrate VM 200 to node pve2"
"List all templates in the cluster"
"Convert VM 102 into a template"
"Set cloud-init on VM 100: user admin, IP dhcp, DNS 8.8.8.8"

Troubleshooting

`Missing required environment variables`

This error means one or more required connection settings are not available to the server process. Copy .env.example to .env, then set PROXMOX_HOST, PROXMOX_TOKEN_ID, and PROXMOX_TOKEN_SECRET. If you configure an MCP client directly, make sure the same variables are present in that client's env block.

`403 Permission check failed`

A 403 usually means the API token is valid but does not have enough Proxmox privileges for the requested operation. Revisit Creating a Proxmox API Token and either uncheck "Privilege Separation" for full access or assign the specific privileges listed there, such as VM.Audit, VM.PowerMgmt, VM.Snapshot, or storage permissions for datastore operations.

`exec_command` fails for guest-agent or LXC reasons

exec_command only works for QEMU VMs with qemu-guest-agent installed and running inside the guest. If the tool reports that the QEMU guest agent is not responding, start or install the agent in the VM and retry. LXC containers are not supported by this Proxmox API path, so use another container access method instead.

`ModuleNotFoundError: No module named 'mcp.server.fastmcp'`

The MCP Python SDK 2.0 removed the mcp.server.fastmcp module that mcp-proxmox 1.2.1 and earlier import. Fresh installs (uvx mcp-proxmox, uv tool install, pip install) resolved mcp 2.x and failed on startup — in Claude Desktop this only shows up as "Server disconnected". Upgrade to mcp-proxmox 1.2.2 or later, which pins mcp<2. If you must stay on an older mcp-proxmox, constrain the SDK yourself: uvx --with "mcp<2" mcp-proxmox.

Self-signed certificate or connection errors

Proxmox commonly runs on port 8006, so check that PROXMOX_HOST and PROXMOX_PORT point to the same endpoint you use for the Proxmox web UI. For homelab clusters with self-signed certificates, leave PROXMOX_VERIFY_SSL=false or set it explicitly. Use PROXMOX_VERIFY_SSL=true only when the Proxmox certificate chains to a CA trusted by your runtime.

Development

bash

git clone https://github.com/felhen-ai/mcp-proxmox.gitcd mcp-proxmoxpython -m venv .venvsource .venv/bin/activatepip install -e ".[dev]"
# Run testspytest
# Lintruff check src/ tests/ruff format src/ tests/
# Type checkmypy src/

git clone https://github.com/felhen-ai/mcp-proxmox.gitcd mcp-proxmoxpython -m venv .venvsource .venv/bin/activatepip install -e ".[dev]"
# Run testspytest
# Lintruff check src/ tests/ruff format src/ tests/
# Type checkmypy src/

License

MIT

Repository and registry compatibility

The canonical repository is https://github.com/felhen-ai/mcp-proxmox. Existing GitHub clone and issue URLs redirect to this repository. Do not recreate a repository at the old address, which would remove those redirects.

The canonical MCP Registry identifier is io.github.felhen-ai/mcp-proxmox. The legacy identifier io.github.antonio-mello-ai/mcp-proxmox remains supported with a separate server.legacy.json manifest. Both identifiers install the same mcp-proxmox package from PyPI, and the package name and CLI command remain unchanged. Keep both ownership markers in this README so future releases can be registered under either identifier.

New Docker publications use ghcr.io/felhen-ai/mcp-proxmox. Existing images and tags at ghcr.io/antonio-mello-ai/mcp-proxmox are retained for compatibility; they are not deleted or silently replaced. The legacy Glama badge above remains a discovery link until that directory migrates its entry.

來源：README.md，提交 e440334

工具

list_nodes

List all nodes in the Proxmox cluster with status, CPU, memory, and uptime.

無需輸入參數。

get_node_status

Get detailed status for a specific node including CPU model, memory, disk, and versions. Args: node: Name of the Proxmox node (e.g. 'pve', 'node1').

輸入參數node必填

list_vms

List all QEMU virtual machines across the cluster. Args: node: Optional. Filter by node name. status: Optional. Filter by status ('running', 'stopped').

輸入參數nodestatus

list_containers

List all LXC containers across the cluster. Args: node: Optional. Filter by node name. status: Optional. Filter by status ('running', 'stopped').

輸入參數nodestatus

get_guest_status

Get detailed status of a VM or container by VMID. Auto-detects type and node. Args: vmid: The numeric ID of the VM or container (e.g. 100, 200).

輸入參數vmid必填

start_guest

Start a stopped VM or container. Args: vmid: The numeric ID of the VM or container to start.

輸入參數vmid必填

stop_guest

Force-stop a running VM or container. WARNING: May cause data loss. Args: vmid: The numeric ID of the VM or container to stop. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數vmid必填confirm

shutdown_guest

Gracefully shut down a VM or container via ACPI signal (VMs) or init (containers). Args: vmid: The numeric ID of the VM or container to shut down.

輸入參數vmid必填

reboot_guest

Reboot a running VM or container. Args: vmid: The numeric ID of the VM or container to reboot. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數vmid必填confirm

list_snapshots

List all snapshots for a VM or container. Args: vmid: The numeric ID of the VM or container.

輸入參數vmid必填

create_snapshot

Create a new snapshot for a VM or container. Args: vmid: The numeric ID of the VM or container. name: Snapshot name (alphanumeric, hyphens, underscores). description: Optional description for the snapshot.

輸入參數name必填vmid必填description

rollback_snapshot

Rollback a VM or container to a previous snapshot. WARNING: All changes since the snapshot will be LOST. Args: vmid: The numeric ID of the VM or container. name: Name of the snapshot to rollback to. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數name必填vmid必填confirm

delete_snapshot

Delete a snapshot from a VM or container. Args: vmid: The numeric ID of the VM or container. name: Name of the snapshot to delete. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數name必填vmid必填confirm

list_storages

List storage pools across the cluster with capacity and usage info. Args: node: Optional. Filter by node name.

輸入參數node

list_storage_content

List content of a storage pool (ISOs, templates, backups, disk images). Args: node: Name of the Proxmox node. storage_name: Name of the storage pool (e.g. 'local', 'local-lvm'). content_type: Optional. Filter by type: 'iso', 'vztmpl', 'backup', 'images', 'rootdir'.

輸入參數node必填content_typestorage_name必填

create_vm

Create a new QEMU virtual machine. The VM is created stopped by default. Use start_after_create=true to auto-start. Args: node: Target node name (e.g. 'pve'). name: VM name. cores: Number of CPU cores (default 1). memory: Memory in MB (default 2048). disk_size: Disk size with unit (default '32G'). Examples: '10G', '100G', '1T'. storage_pool: Storage for disk (default 'local-lvm'). iso: Optional ISO volume ID for installation (e.g. 'local:iso/ubuntu-24.04.iso'). os_type: OS type (default 'l26' for Linux). Options: l26, l24, win11, win10, other. net_bridge: Network bridge (default 'vmbr0'). start_after_create: Start VM after creation (default false). vmid: Optional specific VMID. Auto-assigned if not provided.

輸入參數isoname必填node必填vmidcoresmemoryos_typedisk_sizenet_bridgestorage_poolstart_after_create

create_container

Create a new LXC container from a template. Args: node: Target node name (e.g. 'pve'). name: Container hostname. template: Template volume ID (e.g. 'local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst'). Use list_storage_content with content_type='vztmpl' to find available templates. cores: Number of CPU cores (default 1). memory: Memory in MB (default 512). disk_size: Root disk size in GB (default 8). storage_pool: Storage for rootfs (default 'local-lvm'). net_bridge: Network bridge (default 'vmbr0'). password: Optional root password. ssh_public_keys: Optional SSH public keys for root access. start_after_create: Start container after creation (default false). vmid: Optional specific VMID. Auto-assigned if not provided.

輸入參數name必填node必填vmidcoresmemorypasswordtemplate必填disk_sizenet_bridgestorage_poolssh_public_keysstart_after_create

clone_guest

Clone an existing VM or container. Auto-detects type and node. Creates a full (independent) clone by default. Set full_clone=false for a linked clone. Args: vmid: Source VM/container VMID to clone. new_name: Optional name for the clone. target_node: Optional target node for the clone (for cross-node cloning). full_clone: Full clone (true, default) or linked clone (false). target_storage: Optional target storage for the clone's disks. new_vmid: Optional VMID for the clone. Auto-assigned if not provided.

輸入參數vmid必填new_namenew_vmidfull_clonetarget_nodetarget_storage

delete_guest

Permanently delete a VM or container. IRREVERSIBLE. The guest must be stopped before deletion. All disk images will be destroyed. Args: vmid: The numeric ID of the VM or container to delete. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數vmid必填confirm

list_backups

List backup files across storages. Args: node: Optional. Filter by node name. storage_name: Optional. Filter by storage name. vmid: Optional. Filter by VMID to see backups of a specific guest.

輸入參數nodevmidstorage_name

create_backup

Create a backup (vzdump) of a VM or container. Args: vmid: The numeric ID of the VM or container to back up. storage_name: Target storage for the backup (default 'local'). mode: Backup mode: 'snapshot' (no downtime, default), 'suspend', or 'stop'. compress: Compression: 'zstd' (default), 'lzo', 'gzip', or '0' (none). notes: Optional notes/description for the backup.

輸入參數modevmid必填notescompressstorage_name

restore_backup

Restore a VM or container from a backup file. Args: volid: Volume ID of the backup (e.g. 'local:backup/vzdump-qemu-100-2024_03_04.vma.zst'). Use list_backups to find available backups. node: Target node for the restored guest. vmid: Optional VMID for the restored guest. Auto-assigned if not provided. storage_pool: Storage for restored disks (default 'local-lvm'). guest_type: Type of guest: 'vm' or 'container'. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數node必填vmidvolid必填confirmguest_typestorage_pool

exec_command

Execute a command inside a QEMU VM via the guest agent. Requires qemu-guest-agent to be installed and running inside the VM. Not supported for LXC containers. Args: vmid: The numeric ID of the VM. command: The command to execute (e.g. 'hostname', 'df -h', 'systemctl status nginx'). timeout: Max seconds to wait for command completion (default 30, max 300).

輸入參數vmid必填command必填timeout

vm_screenshot

Capture a PNG screenshot of a QEMU VM's display. The VM must be running. Returns the screenshot as a PNG image. Use this to see the current state of the VM console (login prompt, GUI, boot messages, installer screens, etc.). Args: vmid: The numeric ID of the QEMU VM.

輸入參數vmid必填

vm_send_key

Send a key or key combination to a QEMU VM's console. The VM must be running. Key names are human-readable and auto-converted to QEMU Monitor key codes. Use vm_screenshot first to see the console state. Common keys and combos: - 'enter' — Enter key - 'esc' — Escape key - 'tab' — Tab key - 'space' — Space bar - 'backspace' — Backspace - 'up', 'down', 'left', 'right' — Arrow keys - 'f1'-'f12' — Function keys - 'ctrl-alt-delete' — Ctrl+Alt+Del (reboot) - 'ctrl-c' — Ctrl+C - 'win-r' — Win+R (opens Run dialog on Windows) - 'a'-'z', '0'-'9' — Single character keys Args: vmid: The numeric ID of the QEMU VM. key: Key name or hyphen-separated combo (e.g. 'enter', 'ctrl-alt-delete', 'win-r'). confirm: Must be true to send the key to the VM console.

輸入參數key必填vmid必填confirm

vm_send_text

Type a text string into a QEMU VM's console, character by character. Each character is sent as an individual keypress. Use this to type login credentials, commands, or other text into the VM console. Combine with vm_screenshot to verify the result. Supports printable ASCII characters. Newlines (' ') are sent as Enter. Note: characters requiring Shift (uppercase, symbols like '!', '@') are sent with shift automatically. Args: vmid: The numeric ID of the QEMU VM. text: Text string to type into the VM console (e.g. 'administrator admin '). delay: Delay between keypresses in seconds (default 0.05). confirm: Must be true to type the text into the VM console.

輸入參數text必填vmid必填delayconfirm

get_guest_metrics

Get resource usage metrics (CPU, memory, network, disk I/O) for a VM or container. Args: vmid: The numeric ID of the VM or container. timeframe: Time range for metrics. Options: 'hour', 'day', 'week', 'month', 'year'.

輸入參數vmid必填timeframe

list_tasks

List recent tasks on a Proxmox node (backups, migrations, snapshots, etc.). Args: node: Name of the Proxmox node. limit: Maximum number of tasks to return (default 20, max 100). status: Optional. Filter by task status ('ok', 'error', 'running').

輸入參數node必填limitstatus

list_networks

List network interfaces, bridges, and bonds on a Proxmox node. Args: node: Name of the Proxmox node (e.g. 'pve').

輸入參數node必填

resize_guest

Resize CPU, memory, and/or disk of a VM or container. At least one of cores, memory, or disk_size must be provided. CPU and memory changes take effect on next reboot for running guests. Disk resize is immediate but IRREVERSIBLE (disks can only grow). Args: vmid: The numeric ID of the VM or container. cores: New number of CPU cores. memory: New memory size in MB. disk_size: Disk size change. Use '+10G' to add 10GB, or '50G' for absolute size. Supported units: K, M, G, T. disk: Disk name to resize (default 'scsi0' for VMs, auto-mapped to 'rootfs' for CTs). confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數diskvmid必填coresmemoryconfirmdisk_size

list_firewall_rules

List firewall rules. Can target a specific VM/CT, a node, or the cluster. Args: vmid: Optional. List rules for this VM/container. node: Optional. List rules for this node. Ignored if vmid is provided. If neither vmid nor node is provided, lists cluster-level rules.

輸入參數nodevmid

add_firewall_rule

Add a firewall rule to a VM/CT, node, or cluster. Args: action: Rule action: 'ACCEPT', 'DROP', or 'REJECT'. type_: Rule direction: 'in' (incoming) or 'out' (outgoing). vmid: Optional. Add rule to this VM/container. node: Optional. Add rule to this node. Ignored if vmid is provided. proto: Optional. Protocol: 'tcp', 'udp', 'icmp', etc. dport: Optional. Destination port or range (e.g. '80', '8000-9000', '80,443'). sport: Optional. Source port or range. source: Optional. Source IP/CIDR (e.g. '192.168.1.0/24'). dest: Optional. Destination IP/CIDR. iface: Optional. Network interface (e.g. 'net0'). enable: Enable rule immediately (default true). comment: Optional description for the rule. pos: Optional position in the rule chain (0 = first). If neither vmid nor node is provided, adds a cluster-level rule.

輸入參數posdestnodevmiddportifaceprotosporttype_必填action必填enablesource另有 1 個

delete_firewall_rule

Delete a firewall rule by its position number. Use list_firewall_rules first to see rule positions. Args: pos: Position of the rule to delete (from list_firewall_rules output). vmid: Optional. Delete from this VM/container's rules. node: Optional. Delete from this node's rules. Ignored if vmid is provided. confirm: Must be true to execute. First call without confirm shows a warning. If neither vmid nor node is provided, deletes from cluster-level rules.

輸入參數pos必填nodevmidconfirm

migrate_guest

Live migrate a VM or container to another node in the cluster. Args: vmid: The numeric ID of the VM or container to migrate. target_node: Name of the destination node (e.g. 'pve2'). online: Live migration (true, default) or offline (false). Online keeps the guest running. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數vmid必填onlineconfirmtarget_node必填

list_templates

List all VM templates available in the cluster for cloning.

無需輸入參數。

create_template

Convert a stopped VM into a template. IRREVERSIBLE. Once converted, the VM can no longer be started — it can only be cloned. Args: vmid: The numeric ID of the VM to convert. confirm: Must be true to execute. First call without confirm shows a warning.

輸入參數vmid必填confirm

configure_cloud_init

Configure cloud-init settings on a VM for automated provisioning. At least one parameter must be provided. Changes take effect on next boot. Args: vmid: The numeric ID of the VM. user: Default user name for cloud-init. password: Password for the default user. ssh_keys: SSH public keys (URL-encoded, newline-separated for multiple keys). ip_config: IP configuration string (e.g. 'ip=dhcp' or 'ip=10.0.0.5/24,gw=10.0.0.1'). nameserver: DNS server IP(s), space-separated. searchdomain: DNS search domain(s), space-separated.

輸入參數uservmid必填passwordssh_keysip_confignameserversearchdomain

版本歷史

v1.2.4最新Nov 4, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

近 30 天內可連通25 分
已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。
已列出工具必需15 分
描述必需15 分
圖示10 分
文件15 分
授權條款10 分

Tool	Description
`list_storages`	List storage pools with capacity and usage (filter by node)
`list_storage_content`	Browse ISOs, templates, backups, and disk images

Tool	Description
`get_guest_metrics`	CPU, memory, network, disk I/O over time
`list_tasks`	Recent tasks on a node (backups, migrations, etc.)

Mcp Proxmox

概覽

安裝

在 SourceWeft 中

其他 MCP 客戶端

README

mcp-proxmox

Quick Start

Configuration

Creating a Proxmox API Token

Integration

Claude Desktop

Claude Code

Cursor

Available Tools

Discovery

Lifecycle

Storage

Provisioning

Backup & Restore

Command Execution

Console Interaction

Snapshots

Network

Resize

Monitoring

Firewall

Migration

Templates & Cloud-init

Safety

Examples

Troubleshooting

Missing required environment variables

403 Permission check failed

exec_command fails for guest-agent or LXC reasons

ModuleNotFoundError: No module named 'mcp.server.fastmcp'

Self-signed certificate or connection errors

Development

License

Repository and registry compatibility

工具

list_nodes

get_node_status

list_vms

list_containers

get_guest_status

start_guest

stop_guest

shutdown_guest

reboot_guest

list_snapshots

create_snapshot

rollback_snapshot

delete_snapshot

list_storages

list_storage_content

create_vm

create_container

clone_guest

delete_guest

list_backups

create_backup

restore_backup

exec_command

vm_screenshot

vm_send_key

vm_send_text

get_guest_metrics

list_tasks

list_networks

resize_guest

list_firewall_rules

add_firewall_rule

delete_firewall_rule

migrate_guest

list_templates

create_template

configure_cloud_init

版本歷史

評分

`Missing required environment variables`

`403 Permission check failed`

`exec_command` fails for guest-agent or LXC reasons

`ModuleNotFoundError: No module named 'mcp.server.fastmcp'`