Proxmox MCP Rs is an MCP server tool developed by Nicholaswilde, designed to interface with Proxmox VE instances. Built primarily with Rust, it offers a fast, single-binary solution for managing Proxmox environments. This program provides essential capabilities for users of MCP clients like Claude Desktop and Cline, enabling direct interaction with Proxmox clusters. Its design emphasizes efficiency and compatibility with the MCP standard, making it a valuable addition for those seeking direct management of virtualized infrastructure.

What does Proxmox MCP Rs connect to?

Proxmox MCP Rs is designed to establish connections with a Proxmox VE instance, functioning as an MCP server. This allows it to interact directly with Proxmox clusters, enabling management and monitoring tasks. The tool adheres to the Model Context Protocol (MCP) standard, facilitating communication with various AI clients. Its core purpose is to bridge MCP client applications with the underlying Proxmox virtualization platform, providing a structured interface for operational commands.

Core features and tools

This MCP server exposes several callable tools for Proxmox management. Users can employ list_nodes to view all nodes within a cluster, and list_vms to enumerate virtual machines and LXC containers. For power management, it provides start_vm, stop_vm, shutdown_vm, and reboot_vm, allowing control over the operational state of VMs and containers. These tools collectively offer fundamental capabilities for overseeing and adjusting a Proxmox environment.

Who is it for?

Proxmox MCP Rs targets users of MCP clients such as Claude Desktop and Cline who require direct and efficient management of Proxmox VE instances. It is particularly suitable for individuals seeking a faster, single-binary alternative for Proxmox operations. The tool supports concrete workflows like listing cluster resources and controlling VM power states, making it useful for system administrators or developers working with Proxmox. Skip this if you do not use MCP clients for Proxmox management.

How to get started

The server authenticates using a Proxmox User/Password (Ticket-based) model. Setup involves providing configuration details via environment variables such as PROXMOX_HOST, PROXMOX_USER, and PROXMOX_PASSWORD. Alternatively, users can supply credentials and connection parameters through command-line arguments like "--host", "--user", "--password", and "--no-verify-ssl", with communication occurring over the standard JSON-RPC 2.0 over Stdio transport protocol.

Use cases

• Listing all nodes, virtual machines, and LXC containers present in a Proxmox cluster, providing a quick overview of the environment's resources. This is useful for inventory and monitoring purposes from an MCP client.
• Managing the power state of virtual machines and containers, encompassing actions such as starting, stopping, gracefully shutting down, and rebooting. This enables direct operational control over critical infrastructure components.

Proxmox MCP Rs offers a focused solution for Proxmox VE management through MCP clients. Developed by Nicholaswilde, this Rust-based server provides essential tools for monitoring and controlling virtualized environments, emphasizing speed and direct interaction. Its compatibility with standard MCP clients like Claude Desktop and Cline makes it a practical choice for specific operational needs.