agentify-sh/cursor-proxmox-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

10 stars 4 forks 品質 72 トレンド 18MIT

Repository Install

MCP to manage Proxmox VMs in Cursor

概要

Cursor focused Python-based Model Context Protocol (MCP) server for interacting with Proxmox virtualization platform with fixes and enhancements. - Previously tests would not complete so I fixed them up - I need this to manage my own proxmox instances so I will continue to publish updates and changes as I see fit. - ✨ - Brand new create_vm tool - Support for creating virtual machines with custom configurations - New delete_vm tool - Safe VM deletion (with force deletion option) - Enhanced intelligent storage type detection (LVM/file-based) - 🔧 - start_vm - Start virtual machines - stop_vm - Force stop virtual machines - shutdown_vm - Graceful shutdown - reset_vm - Restart virtual machines - 🐳 - get_containers - List all LXC containers and their status - 📊 - Improved storage pool status monitoring - More detailed cluster health status checks - Rich output formatting and themes - 🌐 - 11 complete REST API endpoints - Production-ready Docker deployment - Perfect Open WebUI...

README

以下は原文 README の抜粋です。原文を見る。

cursor-proxmox-mcp - Proxmox MCP Server for Cursor with OpenAPI (optional)

Cursor focused Python-based Model Context Protocol (MCP) server for interacting with Proxmox virtualization platform with fixes and enhancements.

🆕 New Features and Improvements

All Tests Pass

Previously tests would not complete so I fixed them up

Continued Support

I need this to manage my own proxmox instances so I will continue to publish updates and changes as I see fit.

Major enhancements compared to the original version:

✨ Complete VM Lifecycle Management
- Brand new create_vm tool - Support for creating virtual machines with custom configurations
- New delete_vm tool - Safe VM deletion (with force deletion option)
- Enhanced intelligent storage type detection (LVM/file-based)
🔧 Extended Power Management Features
- start_vm - Start virtual machines
- stop_vm - Force stop virtual machines
- shutdown_vm - Graceful shutdown
- reset_vm - Restart virtual machines
🐳 New Container Support
- get_containers - List all LXC containers and their status
📊 Enhanced Monitoring and Display
- Improved storage pool status monitoring
- More detailed cluster health status checks
- Rich output formatting and themes
🌐 Complete OpenAPI Integration
- 11 complete REST API endpoints
- Production-ready Docker deployment
- Perfect Open WebUI integration
- Natural language VM creation support
🛡️ Production-grade Security and Stability
- Enhanced error handling mechanisms
- Comprehensive parameter validation
- Production-level logging
- Complete unit test coverage

Built With

Cursor
Proxmoxer - Python wrapper for Proxmox API
MCP SDK - Model Context Protocol SDK
Pydantic - Data validation using Python type annotations

Features

🤖 Full integration with Cursor and Open WebUI
🛠️ Built with the official MCP SDK
🔒 Secure token-based authentication with Proxmox
🖥️ Complete VM lifecycle management (create, start, stop, reset, shutdown, delete)
💻 VM console command execution
🐳 LXC container management support
🗃️ Intelligent storage type detection (LVM/file-based)
📝 Configurable logging system
✅ Type-safe implementation with Pydantic
🎨 Rich output formatting with customizable themes
🌐 OpenAPI REST endpoints for integration
📡 11 fully functional API endpoints

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)

GitHub で README 全文を見る

インストール

docker run -d --name proxmox-mcp-api -p 8811:8811 \

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
    "mcpServers": {
        "ProxmoxMCP-Plus": {
            "command": "/absolute/path/to/ProxmoxMCP-Plus/.venv/bin/python",
            "args": ["-m", "proxmox_mcp.server"],
            "cwd": "/absolute/path/to/ProxmoxMCP-Plus",
            "env": {
                "PYTHONPATH": "/absolute/path/to/ProxmoxMCP-Plus/src",
                "PROXMOX_MCP_CONFIG": "/absolute/path/to/ProxmoxMCP-Plus/proxmox-config/config.json",
                "PROXMOX_HOST": "your-proxmox-host",
                "PROXMOX_USER": "username@pve",
                "PROXMOX_TOKEN_NAME": "token-name",
                "PROXMOX_TOKEN_VALUE": "token-value",
                "PROXMOX_PORT": "8006",
                "PROXMOX_VERIFY_SSL": "false",
                "PROXMOX_SERVICE": "PVE",
                "LOG_LEVEL": "DEBUG"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}