ProxmoxMCP-Plus

概述

ProxmoxMCP-Plus通过MCP和OpenAPI协议提供统一的Proxmox VE基础设施控制界面。它支持虚拟机和容器生命周期管理、快照操作、备份工作流、ISO管理和容器命令执行。该服务器采用双面架构，既支持通过MCP客户端进行会话式工作流，也支持通过HTTP/OpenAPI端点进行标准自动化。它实现了长时间运行任务的持久化作业跟踪，并包含容器命令执行的安全机制。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• create_vm

  Create a new virtual machine in Proxmox VE

  试试:Create a Ubuntu VM with 2GB RAM and 1 CPU试试:Create a Windows 10 VM with 50GB disk space
• start_vm

  Start a virtual machine in Proxmox VE

  试试:Start the test-vm server试试:Power on the development VM
• stop_vm

  Stop a virtual machine in Proxmox VE

  试试:Stop the test-vm server试试:Shut down the development VM
• delete_vm

  Delete a virtual machine from Proxmox VE

  试试:Delete the test-vm server试试:Remove the development VM
• create_snapshot

  Create a snapshot of a virtual machine or container

  试试:Create a snapshot of the database VM before updates试试:Backup the container state
• rollback_snapshot

  Roll back a virtual machine or container to a previous snapshot

  试试:Rollback the database VM to yesterday's snapshot试试:Restore container to last backup
• delete_snapshot

  Delete a snapshot from a virtual machine or container

  试试:Delete the old snapshot from test-vm试试:Remove the temporary backup snapshot
• create_lxc

  Create a new Linux container in Proxmox VE

  试试:Create a Ubuntu container with 1GB RAM试试:Make a Debian LXC for testing
• start_lxc

  Start a Linux container in Proxmox VE

  试试:Start the database container试试:Boot up the web server container
• stop_lxc

  Stop a Linux container in Proxmox VE

  试试:Stop the database container试试:Shut down the web server container
• delete_lxc

  Delete a Linux container from Proxmox VE

  试试:Delete the test container试试:Remove the old development container
• list_jobs

  List all persistent jobs tracked by the server

  试试:Show me all running jobs试试:List completed tasks from today

可对比工具

安装

pip install proxmox-mcp-plus
proxmox-mcp-plus

docker run --rm -p 8811:8811 \
  -e PROXMOX_API_KEY="$(openssl rand -hex 32)" \
  -v "$(pwd)/proxmox-config/config.json:/app/proxmox-config/config.json:ro" \
  ghcr.io/rekklesna/proxmoxmcp-plus:latest

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "python",
      "args": ["/path/to/ProxmoxMCP-Plus/main.py"],
      "env": {
        "PROXMOX_MCP_CONFIG": "/path/to/ProxmoxMCP-Plus/proxmox-config/config.json"
      }
    }
  }
}

FAQ

ProxmoxMCP-Plus支持哪些认证方法？

它使用Proxmox API令牌认证，需要用户名、令牌名称和令牌值。对于容器命令执行，它支持SSH密钥认证。

如何处理长时间运行的任务？

服务器实现了持久化作业存储（默认为SQLite），用于跟踪任务状态、进度和重试信息。作业可以通过MCP工具或OpenAPI端点列出、轮询、取消或重试。

ProxmoxMCP-Plus 对比