proxmox-mcp

[](https://github.com/JoshuaGreeff/proxmox-mcp/actions/workflows/ci.yml) [](https://github.com/JoshuaGreeff/proxmox-mcp/actions/workflows/codeql.yml) [](https://github.com/JoshuaGreeff/proxmox-mcp/actions/workflows/scorecards.yml) [](./LICENSE) [](./docs/production-readiness.md) [](https://github.com/JoshuaGreeff/proxmox-mcp/stargazers)

Proxmox-MCP is a typed MCP server for operating Proxmox VE through three layers used together:

• Proxmox REST for the management plane
• Proxmox CLI over SSH for node-local coverage gaps
• explicit shell and file escape hatches for high-risk host and guest operations

The server is built against the official Proxmox API schema vendored in vendor/pve-docs.

The framework grows by validated domain modules. A workflow only becomes a typed MCP tool after it has been exercised end-to-end in the lab. Everything else remains available through the generic API/CLI/shell/file escape hatches until it is validated.

The maintained schema-derived roadmap for module coverage lives in module-inventory.md.

What this is:

• a real MCP server with typed Proxmox tools backed by official upstream docs and schema
• a client-agnostic control surface that works over stdio today and targets remote HTTP deployment with OIDC
• an operator-focused server that keeps high-risk