AI导哈

Proxmox管理工具

Proxmox MCP Server是一个用于管理Proxmox VE虚拟机和容器的工具，提供55种日常管理功能。

  • by ruashots
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Ruashots/proxmox-mcp

使用说明

Proxmox MCP服务器

用于Proxmox VE API的MCP（模型上下文协议）服务器。通过Claude Code管理虚拟机和容器。

特性

55个必备工具 用于日常Proxmox管理：

  • 节点：列出节点，获取状态和版本
  • QEMU虚拟机：列表、状态、启动/停止/重新启动、快照、克隆、迁移
  • LXC集装箱：列表、状态、启动/停止/重新启动、快照、克隆、迁移
  • 存储：列出存储、浏览内容、检查状态
  • 任务：查看正在运行的任务和日志

快速安装

curl -fsSL https://raw.githubusercontent.com/Ruashots/proxmox-mcp/master/install.sh | bash

先决条件

  • Node.js 18+
  • jq (sudo apt install jq)
  • Proxmox VE 7.0+ 使用API令牌

手动安装

git clone https://github.com/Ruashots/proxmox-mcp.git ~/.local/share/proxmox-mcp
cd ~/.local/share/proxmox-mcp
npm install && npm run build

添加 ~/.claude.json:

{
  "mcpServers": {
    "proxmox-mcp": {
      "command": "node",
      "args": ["/home/YOUR_USER/.local/share/proxmox-mcp/dist/index.js"],
      "env": {
        "PROXMOX_HOST": "https://192.168.1.100:8006",
        "PROXMOX_TOKEN_ID": "root@pam!claude",
        "PROXMOX_TOKEN_SECRET": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

工具

节点

工具 说明
pve_list_nodes 列出所有节点
pve_get_nodes_status 获取节点状态
pve_get_nodes_version 获取节点版本

QEMU虚拟机

工具 说明
pve_list_nodes_qemu 列出节点上的所有虚拟机
pve_get_nodes_qemu 获取VM详细信息
pve_get_nodes_qemu_config 获取VM配置
pve_update_nodes_qemu_config 更新VM配置
pve_get_nodes_qemu_status_current 获取当前VM状态
pve_create_nodes_qemu_status_start 启动VM
pve_create_nodes_qemu_status_stop 停止VM（硬）
pve_create_nodes_qemu_status_shutdown 关闭虚拟机（优雅）
pve_create_nodes_qemu_status_reboot 重新启动VM
pve_create_nodes_qemu_status_suspend 挂起VM
pve_create_nodes_qemu_status_resume 恢复虚拟机
pve_list_nodes_qemu_snapshot 列出快照
pve_create_nodes_qemu_snapshot 创建快照
pve_get_nodes_qemu_snapshot 获取快照详细信息
pve_delete_nodes_qemu_snapshot 删除快照
pve_create_nodes_qemu_snapshot_rollback 回滚到快照
pve_create_nodes_qemu_clone 克隆虚拟机
pve_create_nodes_qemu_migrate 将VM迁移到另一个节点

LXC集装箱

工具 说明
pve_list_nodes_lxc 列出节点上的所有容器
pve_get_nodes_lxc 获取容器详细信息
pve_get_nodes_lxc_config 获取容器配置
pve_update_nodes_lxc_config 更新容器配置
pve_get_nodes_lxc_status_current 获取当前容器状态
pve_create_nodes_lxc_status_start 启动容器
pve_create_nodes_lxc_status_stop 停止集装箱
pve_create_nodes_lxc_status_shutdown 关闭容器
pve_create_nodes_lxc_status_reboot 重新启动容器
pve_create_nodes_lxc_status_suspend 悬挂集装箱
pve_create_nodes_lxc_status_resume 简历容器
pve_list_nodes_lxc_snapshot 列出快照
pve_create_nodes_lxc_snapshot 创建快照
pve_get_nodes_lxc_snapshot 获取快照详细信息
pve_delete_nodes_lxc_snapshot 删除快照
pve_create_nodes_lxc_snapshot_rollback 回滚到快照
pve_create_nodes_lxc_clone 克隆容器
pve_create_nodes_lxc_migrate 迁移容器

存储

工具 说明
pve_list_nodes_storage 列出节点上的存储
pve_get_nodes_storage_status 获取存储状态
pve_list_nodes_storage_content 列出存储内容

任务

工具 说明
pve_list_nodes_tasks 列出任务
pve_get_nodes_tasks_status 获取任务状态
pve_get_nodes_tasks_log 获取任务日志

示例用法

  • “列出节点pve上的所有VM”
  • “在节点pve上启动VM 100”
  • “创建更新前调用的容器101的快照”
  • “显示节点pve上的存储状态”
  • “节点pve上正在运行哪些任务？”

创建API令牌

  1. Proxmox用户界面→ 数据中心→ 权限→ API令牌→ Add
  2. 选择用户（例如。， root@pam)输入令牌ID（例如。， claude)
  3. 取消选中“特权分离”以获得完全访问权限
  4. 立即复制秘密！

许可证

麻省理工学院

相关 MCP