proxmox-mcp

proxmox-mcp 是一个带有安全门控的本地 stdio Model Context Protocol 服务器，用于 Proxmox VE API。它由 MCP 主机作为进程启动；它不是 HTTP 服务，也不暴露 HTTP 端点。

状态 — 当前版本：v0.1.1。 官方分发渠道是 GitHub Release 归档文件及其 SHA-256 校验和。不提供也不发布 npm 包。

安装已发布的 Proxmox MCP

对于本地 stdio 安装，请使用经过校验和验证的 GitHub Release 归档文件：

• GitHub Release v0.1.1

• 归档文件

• 校验和文件

没有 npm 包。LobeHub Marketplace 列表 描述了功能；它不是本地安装源。ClawHub 目前尚未发布，因为尚无可公开安装的 OpenClaw 包装器/列表。

Related MCP server: mcp-server-proxmox

快速安装

从 GitHub Releases 下载 v0.1.1 归档文件和校验和，验证它们，然后解压归档文件。在 MCP 主机将要运行的机器上执行此操作。

curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz
curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz.sha256
shasum -a 256 -c proxmox-mcp-0.1.1.tar.gz.sha256
tar -xzf proxmox-mcp-0.1.1.tar.gz
cd proxmox-mcp-0.1.1

该归档文件需要 Node.js >=22。通过环境变量提供凭据；以下值是占位符，并非有效凭据。

export PROXMOX_BASE_URL='https://proxmox.example:8006'
export PROXMOX_TOKEN_ID='user@realm!token-name'
: "${PROXMOX_TOKEN_SECRET:?set PROXMOX_TOKEN_SECRET in the environment}"
./proxmox-mcp

./proxmox-mcp 是一个 stdio 进程。在您的 MCP 主机中注册或配置该命令、其工作目录以及三个环境变量；仅在终端中启动它并不会使其对客户端可用。有关归档文件布局和安装详情，请参阅 GitHub Release 安装指南。

配置

仅使用以下环境变量：

TLS 证书验证始终启用。PROXMOX_TLS_VERIFY=false 在启动时会被拒绝；请勿使用。如果 Proxmox 端点使用私有 CA，请在主机信任存储中信任该 CA。有关完整策略，请参阅 配置。

功能

该服务器提供一组集中的 Proxmox VE 操作。MCP 主机在连接时发现确切的模式（schemas）和工具描述。

工具名称、输入、输出和节点名称验证规则记录在 工具契约 中。

安全模型

删除、未使用磁盘移除和强制停止可能是不可恢复的。请仔细审查目标，并仅授予令牌所需的 Proxmox 权限。请参阅完整的 安全指南。

OpenClaw 本地技能

合并后的 dev 代码库包含一个 OpenClaw 技能，位于 skills/proxmox-mcp-openclaw/。它是一个本地技能，不是通用的 OpenClaw 插件。请使用其本地 SKILL.md 说明。

选择一个新的绝对目标目录——该目录必须尚不存在。首先检查无需凭据的计划：

node skills/proxmox-mcp-openclaw/scripts/install.mjs --dry-run /absolute/path/to/proxmox-mcp

在 shell 中导出三个配置变量后，安装并注册它：

node skills/proxmox-mcp-openclaw/scripts/install.mjs /absolute/path/to/proxmox-mcp

安装程序验证不可变的 v0.1.1 版本及其校验和，然后仅在预检成功后调用受支持的 openclaw mcp add 命令。它不会记录或存储凭据。

操作边界

• 这是一个本地 stdio MCP 集成，不是托管服务，也不是 Proxmox 访问控制的替代品。

• 服务器在 MCP 客户端调用工具之前不会发出 Proxmox 请求。安装和文档示例不会调用真实的 Proxmox API。

• 将凭据排除在仓库、shell 历史记录（在可行的情况下）和共享配置文件之外。使用最小权限的 Proxmox API 令牌。

• 仅从 Theorvane/proxmox-mcp GitHub Releases 获取版本，并在运行归档文件之前验证已发布的 SHA-256 校验和。

文档

• 配置

• 安全

• API 和工具契约

• GitHub Release 安装

• 贡献指南

• 安全策略

验证与贡献

贡献者从基于 dev 的带问题编号的分支开始工作，向 dev 打开拉取请求，并且仅将经过审查的 dev 提升到 main。GitHub Release 归档文件是唯一的分发渠道。请参阅 CONTRIBUTING.md。

维护者可以运行项目使用的相同本地验证命令：

npm ci
npm run lint
npm run typecheck
npm test
npm run build
npm run release:archive
npm run verify:release-archive
npm run validate:docs
npm run validate:governance
npm run validate:release
npm audit --omit=dev --audit-level=high
git diff --check

许可证

本项目根据 许可证 中的条款进行许可。