MCP Proxmox (Antonio Mello AI)

mcp proxmox

MCP服务器，用于通过Claude、Cursor和Cline等人工智能助手管理Proxmox VE集群。

通过自然语言配置、管理和监控整个Proxmox基础架构。创建虚拟机和容器、管理快照、浏览存储等。

快速开始

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

# Or install with pip
pip install mcp-proxmox

配置

设置这些环境变量（或创建 .env 文件）：

PROXMOX_HOST=192.168.1.100          # Your Proxmox VE host
PROXMOX_TOKEN_ID=user@pam!mcp       # API token ID
PROXMOX_TOKEN_SECRET=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  # API token secret

可选：

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

创建Proxmox API令牌

1. 登录到Proxmox web UI
2. 首选 数据中心 > 权限 > API令牌
3. 点击 添加 并为您的用户创建一个令牌
4. 取消勾选 完全访问或分配特定权限的“特权分离”：

- VM.Audit --读取VM/CT状态和配置 - VM.PowerMgmt --启动/停止/关闭/重新启动 - VM.Snapshot --创建/回滚/删除快照 - VM.Allocate --创建/删除/克隆虚拟机和容器 - VM.Clone --克隆操作 - Datastore.Audit --列出存储和浏览内容 - Datastore.AllocateSpace --为新的VM/CT分配磁盘空间 - Sys.Audit --读取节点状态和任务 - VM.Config.Disk --调整磁盘大小 - VM.Config.CPU --更改CPU分配 - VM.Config.Memory --更改内存分配 - VM.Monitor --访问QEMU监视器（用于度量） - VM.Migrate --在节点之间迁移VM/CT - Sys.Modify --管理防火墙规则 - VM.Config.Cloudinit --配置云初始化参数

整合

克劳德桌面版

添加 ~/.claude/claude_desktop_config.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"
      }
    }
  }
}

克劳德代码

添加 .claude/settings.json 或 ~/.claude/settings.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"
      }
    }
  }
}

光标

使用与上述相同的配置添加到光标设置>MCP。

可用工具

发现

生命周期

存储

配置

备份与恢复

命令执行

注： exec_command 需要 qemu-guest-agent 在VM内部安装并运行。LXC容器不支持（Proxmox API限制）。

快照

网络

调整大小

监控

防火墙

迁移

模板和云初始化

安全

破坏性行动(stop_guest, reboot_guest, rollback_snapshot, delete_snapshot, delete_guest, resize_guest, restore_backup, delete_firewall_rule, migrate_guest, create_template)要求明确 confirm=true第一个调用返回描述影响的警告；只有具有确认的第二次调用执行该动作。

例子

连接后，您可以询问您的AI助手：

• “列出我的所有虚拟机及其状态”
• “VM 100使用了多少内存？”
• “关闭105号集装箱”
• “创建升级前调用的VM 200的快照”
• “显示VM 100在过去一天的CPU使用情况”
• “最近在节点pve上运行了哪些任务？”
• “哪些虚拟机被停止？”
• “我有哪些存储池，它们有多满？”
• “显示可用的ISO图像”
• “创建一个具有4个内核和8GB RAM的新Ubuntu VM”
• “将VM 100克隆为测试环境”
• “从模板创建Debian容器”
• “删除旧的测试VM 999”
• “将VM 100备份到zfs备份存储”
• “显示VM 200的所有备份”
• “还原容器101的最新备份”
• “在VM 100上运行‘df-h’”
• “检查nginx是否在VM 200上运行”
• “显示节点pve上的网桥”
• “为VM增加100个CPU——将其提升到8个核心”
• “向容器101添加50GB磁盘”
• “显示VM 100上的防火墙规则”
• “允许容器101上的TCP端口443”
• “将VM 200迁移到节点pve2”
• “列出群集中的所有模板”
• “将VM 102转换为模板”
• 在VM 100上设置云初始化：用户管理员、IP dhcp、DNS 8.8.8.8

发展

git clone https://github.com/antonio-mello-ai/mcp-proxmox.git
cd mcp-proxmox
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/ tests/
ruff format src/ tests/

# Type check
mypy src/

许可证

麻省理工学院