Skip to main content
Glama
proxmox-safe-mcp

proxmox-safe-mcp

by bgauger

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: rustproxmoxmcp

安装与运行

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。

Available Tools

5 tools
cluster_statusD

Inputs: no named parameters. Returns: object

guest_powerD

Inputs: node (required), vmid (required), action (required), guest_type (required), +1 more. Returns: object

list_guestsD

Inputs: no named parameters. Returns: result

node_statusD

Inputs: node (required).

snapshot_guestD

Inputs: node (required), vmid (required), guest_type (required), snapshot_name (required), +1 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of the Proxmox environment: cluster status, node status, guest listing, guest power control, and guest snapshotting. There is no overlap in purposes, making selection unambiguous.

    Naming Consistency3/5

    The names mix noun-initial patterns (cluster_status, node_status, guest_power) with verb-initial patterns (list_guests, snapshot_guest). This inconsistency is noticeable but still readable and predictable overall.

    Tool Count5/5

    With only 5 tools, the server is tightly scoped and each tool serves a clear purpose. This is well-balanced for a specialized MCP server focused on monitoring and safe guest operations.

    Completeness3/5

    The set covers status, listing, power, and snapshot operations but lacks lifecycle management (create, update, delete guests). While potentially intentional for a 'safe' server, it leaves notable gaps for full Proxmox administration.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Enables an AI assistant to fully navigate a single-node Proxmox VE host over SSH, with modes for read-only inspection, safe operations, and full control including provisioning and destruction.
      34
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables management of many Proxmox VE clusters from a single server, exposing read and inventory tools plus guarded destructive operations that follow a plan → approve → apply flow. Per-cluster tokens, fail-closed guest protection with time-boxed waivers, and audit logging keep every action scoped, attributable, and reversible.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP clients to diagnose Proxmox VE clusters — quorum and HA state, Ceph and ZFS health, backup coverage audits, task failures, pending updates and node evacuation planning — with answers returned as findings and recommended steps. VM power, snapshot and migration operations are available but disabled by default, requiring a preview and a bound confirmation token before anything executes.
      13
      33 PyPI
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables schema-validated access to all 680 Proxmox VE API endpoints plus curated guest, snapshot, backup, storage, and task tools, with read-only behavior by default and controlled writes when explicitly enabled.
      20
      AGPL 3.0