Proxmoxハイパーバイザーとやり取りするためのPythonベースのModel Context Protocol(MCP)サーバーで、ノード、VM、コンテナの管理にクリーンなインターフェースを提供します。

🏗️ ビルト・ウィズ

• Cline - 自律コーディングエージェント - Clineでより速く動作します。
• Proxmoxer - Proxmox API用のPythonラッパー
• MCP SDK - モデルコンテキストプロトコルSDK
• Pydantic - Python型注釈を用いたデータ検証

✨ 特徴

• 🤖 クラインとの完全統合
• 🛠️ 公式MCP SDKで構築
• 🔒 Proxmoxによる安全なトークンベースの認証
• 🖥️ ノードおよびVM管理のためのツール
• 💻 VMコンソールコマンド実行
• 📝 設定可能なログシステム
• ✅ Pydanticを用いた型安全実装
• 🎨 カスタマイズ可能なテーマを備えたリッチな出力フォーマット

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

📦 設置

前提条件

• UVパッケージマネージャー(推奨)
• Python 3.10以降
• ギット
• APIトークン認証情報によるProxmoxサーバーへのアクセス

始める前に、以下の条件を確認してください:

• [ ] Proxmoxサーバーのホスト名またはIP
• [ ] Proxmox APIトークン(APIトークン設定参照)
• [ ] UV設置(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