ProxmoxMCP

ProxmoxMCP

106
virtualization

Proxmox Manager is a Python-based MCP server designed for managing Proxmox hypervisors. It offers tools for managing nodes, VMs, and containers, and integrates with Cline and Proxmoxer for seamless operation. It features secure authentication, rich output formatting, and development tools for effective hypervisor management.

🚀 Proxmox Manager - Proxmox MCP Server

A Python-based Model Context Protocol (MCP) server for interacting with Proxmox hypervisors, providing a clean interface for managing nodes, VMs, and containers.

🏗️ Built With

  • Cline - Autonomous coding agent.
  • Proxmoxer - Python wrapper for Proxmox API
  • MCP SDK - Model Context Protocol SDK
  • Pydantic - Data validation using Python type annotations

✨ Features

  • Full integration with Cline
  • Built with the official MCP SDK
  • Secure token-based authentication with Proxmox
  • Tools for managing nodes and VMs
  • VM console command execution
  • Configurable logging system
  • Type-safe implementation with Pydantic
  • Rich output formatting with customizable themes

📦 Installation

Prerequisites

  • UV package manager
  • Python 3.10 or higher
  • Git
  • Access to a Proxmox server with API token credentials

🚀 Running the Server

Development Mode

Activate virtual environment and run the server.

🔧 Available Tools

  • get_nodes: Lists all nodes in the Proxmox cluster.
  • get_node_status: Get detailed status of a specific node.
  • get_vms: List all VMs across the cluster.
  • get_storage: List available storage.
  • get_cluster_status: Get overall cluster status.
  • execute_vm_command: Execute a command in a VM's console using QEMU Guest Agent.