rekklesna/proxmoxmcp-plus

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

628 stars 101 forks 质量 92 趋势 44MIT

Repository Install

rekklesna/proxmoxmcp-plus 是从 https://github.com/rekklesna/proxmoxmcp-plus. 导入的 MCP 服务器候选服务器。

概览

rekklesna/proxmoxmcp-plus 是从 https://github.com/rekklesna/proxmoxmcp-plus. 导入的 MCP 服务器候选服务器。

概述（AI 翻译）

通过一个注重安全意识的控制平面，通过一个注重安全意识的控制平面操作 Proxmox VE，涵盖虚拟机、LXC、快照、备份、ISO、容器命令和持久的长期运行作业。

快速入门 | 客户端安装 | 演示 | 工具 | 安全 | 场景 | 文档 | 维基

MCP 和 OpenAPI 是进入相同工作流程的替代入口，可能在独立进程中运行。实心箭头表示请求和执行;虚线箭头表示显示持久作业和审计状态。批准门、SSH执行和MCP HTTP 这取决于配置。选择图纸以查看全尺寸。

为什么是ProxmoxMCP-Plus的

ProxmoxMCP-Plus 介于 AI 客户端和 Proxmox VE 之间，操作员无需为每个工作流程拼接原始 API 调用、一次性 shell 脚本和自定义作业轮询。

它通过两种方式暴露相同的操作表面：

MCP 适用于 Claude Desktop、Cursor、VS Code、Open WebUI、Codex 及其他支持 MCP 的代理
OpenAPI 用于 HTTP 自动化、仪表盘、内部工具和无代码工作流程

你能获得什么：

虚拟机和LXC生命周期操作
快照创建、回滚和删除
备份和恢复工作流程

本页由 AI 翻译，技术细节请以原文为准。

README

以下为原文 README 节选，完整内容请查看原文。

ProxmoxMCP-Plus

Operate Proxmox VE from MCP clients, AI agents, and OpenAPI tooling through one security-conscious control plane for VMs, LXCs, snapshots, backups, ISOs, container commands, and persistent long-running jobs.

MCP and OpenAPI are alternative entry points into the same workflows and may run in separate processes. Solid arrows show requests and execution; dashed arrows show persisted job and audit state. Approval gates, SSH execution and MCP HTTP OAuth depend on configuration. Select the diagram to view it at full size.

Why ProxmoxMCP-Plus

ProxmoxMCP-Plus sits between AI clients and Proxmox VE so operators do not have to stitch together raw API calls, one-off shell scripts, and custom job polling for every workflow.

It exposes the same operational surface in two ways:

MCP for Claude Desktop, Cursor, VS Code, Open WebUI, Codex, and other MCP-capable agents
OpenAPI for HTTP automation, dashboards, internal tools, and no-code workflows

What you get:

VM and LXC lifecycle actions
snapshot create, rollback, and delete
backup and restore workflows
ISO download and cleanup
node, storage, and cluster inspection
SSH-backed container command execution with guardrails
opt-in guarded Proxmox node SSH commands
persistent job tracking for async Proxmox tasks

What Makes It Different

在 GitHub 查看完整 README

安装

uvx proxmox-mcp-plus

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": ["proxmox-mcp-plus"],
      "env": {
        "PROXMOX_HOST": "your-proxmox-host",
        "PROXMOX_USER": "root@pam",
        "PROXMOX_TOKEN_NAME": "mcp-token",
        "PROXMOX_TOKEN_VALUE": "your-token-secret",
        "PROXMOX_PORT": "8006",
        "PROXMOX_VERIFY_SSL": "true"
      }
    }
  }
}