基于Python的模型上下文协议（MCP）服务器，用于与Proxmox虚拟机监控程序交互，提供管理节点、虚拟机和容器的简洁界面。

🏗️ 与

• Cline - 自主编码代理 - 使用 Cline 更快。
• Proxmoxer - Proxmox API 的 Python 包装器
• MCP SDK - 模型上下文协议 SDK
• Pydantic - 使用Python类型注释进行数据验证

✨ 特色

• 🤖 与Cline的全面集成
• 🛠️ 使用官方MCP SDK构建
• 🔒 通过Proxmox实现基于令牌的安全认证
• 🖥️ 管理节点和虚拟机的工具
• 💻 虚拟机控制台命令执行
• 📝 可配置日志系统
• ✅ 使用 Pydantic 实现类型安全
• 🎨 丰富的输出格式，并可自定义主题

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

📦 安装

先决条件

• UV包管理器（推荐）
• Python 3.10 或更高版本
• 走
• 通过API令牌凭证访问Proxmox服务器

开始前，请确保您具备：

• [ ] Proxmox 服务器主机名或 IP
• [ ] Proxmox API 令牌（参见 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