Proxmox Safe MCP

一个专注的 Proxmox MCP 服务器，提供受限的库存/状态读取，并且仅包含两类狭窄的变更操作：白名单内的客户机电源操作和快照创建。从 spectrenet-mcp 提交 2e63f009d8f4642e17398685baef0251811d6637 中提取；本仓库是自包含的。

Alpha： 测试是模拟的。Proxmox API 兼容性尚未针对每个版本进行认证；请在非生产基础设施上进行测试。

安全契约

• 节点针对节点定向操作（node_status）和两个变更工具均被明确列入白名单；客户机类型仅为 qemu 和 lxc；VMID 必须是正整数。

• cluster_status 和 list_guests 有意返回集群范围的 API 视图，不受节点白名单过滤。请限定专用 Proxmox API 账户/令牌的范围，以限制这些读取工具所能看到的内容。

• 电源操作仅限于 start、shutdown、reboot 和 stop。

• 快照名称由 1–64 个 ASCII 字母、数字、_ 或 - 组成。

• 每次变更操作都需要逐字节匹配的 APPROVE <action> <target> 确认。

• 变更响应是提交回执，而非完成证明。请分别验证返回的 UPID 和最终状态。

• 不存在客户机/快照删除、主机电源、存储变更、分配、迁移或配置工具。node_status 有意排除了存储枚举。

• 响应/列表/审计字段均受限，TLS 验证默认开启。

Related MCP server: ProxmoxMCP-Plus

安装与运行

uv sync --extra test
uv run proxmox-safe-mcp --help
uv run proxmox-safe-mcp

服务器使用 MCP stdio。它不会加载 .env；请仅将 .env.example 作为示例文档使用，并通过监督进程或密钥管理器注入机密信息。

验证

uv sync --locked --extra test
uv run --locked pytest
uv run --locked python -m compileall -q src tests
uv build

参见架构与运维和安全详情。MIT © 2026 Ben Gauger。