Proxmox 하이퍼바이저와 상호작용하기 위한 Python 기반 모델 컨텍스트 프로토콜(MCP) 서버로, 노드, 가상 머신, 컨테이너 관리를 위한 깨끗한 인터페이스를 제공합니다.

🏗️ 함께 만들어졌다

• Cline - 자율 코딩 에이전트 - Cline으로 더 빠르게 진행합니다.
• Proxmoxer - Proxmox API용 파이썬 래퍼
• MCP SDK - 모델 컨텍스트 프로토콜 SDK
• 파이던틱 - 파이썬 타입 주석을 이용한 데이터 검증

✨ 특징

• 🤖 클라인과의 완전 통합
• 🛠️ 공식 MCP SDK로 빌드됨
• 🔒 Proxmox를 통한 안전한 토큰 기반 인증
• 🖥️ 노드 및 가상 머신 관리를 위한 도구
• 💻 VM 콘솔 명령 실행
• 📝 구성 가능한 로깅 시스템
• ✅ Pydantic을 이용한 타입 안전 구현
• 🎨 맞춤형 테마가 있는 풍부한 출력 포맷

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

📦 설치

전제 조건

• UV 패키지 관리자 (권장)
• Python 3.10 이상
• git
• 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