Сервер Model Context Protocol (MCP) на основе Python для взаимодействия с гипервизорами Proxmox, обеспечивающий чистый интерфейс для управления узлами, виртуальными машинами и контейнерами.

🏗️ Построено вместе

• Клайн — автономный кодировщик — быстрее с помощью Клайна.
• Proxmoxer — обёртка Python для API Proxmox
• MCP SDK — SDK протокола контекста модели
• Pydantic — проверка данных с использованием аннотаций типа Python

✨ Особенности

• 🤖 Полная интеграция с Cline
• 🛠️ Построен с использованием официального MCP SDK
• 🔒 Защищённая аутентификация на основе токенов с помощью Proxmox
• 🖥️ Инструменты для управления узлами и виртуальными машинами
• 💻 Выполнение команд в консоли VM
• 📝 Настраиваемая система логирования
• ✅ Типово-безопасная реализация с помощью Pydantic
• 🎨 Насыщенное форматирование выхода с настраиваемыми темами

https://github.com/user-attachments/assets/1b5f42f7-85d5-4918-aca4-d38413b0e82b

📦 Установка

Требования

• UV-менеджер пакетов (рекомендуется)
• Python 3.10 или выше
• Иди
• Доступ к серверу Proxmox с учётными данными токенов API

Перед началом работы убедитесь, что у вас:

• [ ] Хост-имя или IP сервера Proxmox
• [ ] Токен API Proxmox (см. Настройка токена API)
• [ ] УФ-установка (pip install uv)

Вариант 1: Быстрая установка (рекомендуется)

1. Клонировать и настроить окружение:

🚀 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 - Go faster with Cline.
• 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

https://github.com/user-attachments/assets/1b5f42f7-85d5-4918-aca4-d38413b0e82b

📦 Installation

Prerequisites

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

Before starting, ensure you have:

• [ ] Proxmox server hostname or IP
• [ ] Proxmox API token (see API Token Setup)
• [ ] UV installed (pip install uv)

Option 1: Quick Install (Recommended)

1. Clone and set up environment:

   # Clone repository
   cd ~/Documents/Cline/MCP  # For Cline users
   # OR
   cd your/preferred/directory  # For manual installation
   
   git clone https://github.com/canvrno/ProxmoxMCP.git
   cd ProxmoxMCP
   
   # Create and activate virtual environment
   uv venv
   source .venv/bin/activate  # Linux/macOS
   # OR
   .\.venv\Scripts\Activate.ps1  # Windows
   

2. Install dependencies:

   # Install with development dependencies
   uv pip install -e ".[dev]"
   

3. Create configuration:

   # Create config directory and copy template
   mkdir -p proxmox-config
   cp config/config.example.json proxmox-config/config.json
   

4. Edit proxmox-config/config.json:

   {
       "proxmox": {
           "host": "PROXMOX_HOST",        # Required: Your Proxmox server address
           "port": 8006,                  # Optional: Default is 8006
           "verify_ssl": false,           # Optional: Set false for self-signed certs
           "service": "PVE"               # Optional: Default is PVE
       },
       "auth": {
           "user": "USER@pve",            # Required: Your Proxmox username
           "token_name": "TOKEN_NAME",    # Required: API token ID
           "token_value": "TOKEN_VALUE"   # Required: API token value
       },
       "logging": {
           "level": "INFO",               # Optional: DEBUG for more detail