mcp-proxmox

gilby125/mcp-proxmox

3.3

If you are the rightful owner of mcp-proxmox and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Node.js-based Model Context Protocol (MCP) server for managing Proxmox hypervisors with configurable permissions.

The Proxmox MCP Server (Node.js Edition) is a robust server application designed to facilitate seamless interaction with Proxmox hypervisors. Rewritten from its original Python version, this Node.js implementation leverages the Model Context Protocol SDK to provide a streamlined interface for managing nodes, virtual machines (VMs), and containers. It introduces configurable permission levels, allowing users to operate in either a basic or elevated mode, ensuring security and flexibility. The server supports secure token-based authentication and offers real-time resource monitoring, making it an ideal solution for administrators seeking efficient and secure Proxmox management.

Features

  • Configurable Security: Offers two permission levels for safe operation.
  • Built with MCP SDK: Utilizes the official Model Context Protocol SDK for Node.js.
  • Secure Authentication: Implements token-based authentication with Proxmox.
  • Comprehensive Management: Provides extensive node and VM management capabilities.
  • Real-time Monitoring: Supports real-time resource monitoring and command execution.

Usages

usage with Claude Code

{
  "mcpServers": {
    "mcp-proxmox": {
      "command": "node",
      "args": ["index.js"],
      "cwd": "/absolute/path/to/mcp-proxmox"
    }
  }
}

Tools

  1. proxmox_get_nodes

    Lists all nodes in the Proxmox cluster with their status and resources.

  2. proxmox_get_node_status

    Get detailed status of a specific node (requires elevated permissions).

  3. proxmox_get_vms

    List all virtual machines across the cluster with their status.

  4. proxmox_get_vm_status

    Get detailed status information for a specific VM.

  5. proxmox_get_storage

    List all storage pools and their usage across the cluster.

  6. proxmox_get_cluster_status

    Get overall cluster status including nodes and resource usage.

  7. proxmox_execute_vm_command

    Execute a shell command on a virtual machine via Proxmox API (requires elevated permissions).