ProxmoxMCP-Plus

RekklesNA/ProxmoxMCP-Plus

3.3

If you are the rightful owner of ProxmoxMCP-Plus and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

ProxmoxMCP-Plus is an enhanced Python-based Model Context Protocol (MCP) server designed for managing Proxmox virtualization platforms with advanced features and OpenAPI integration.

ProxmoxMCP-Plus builds upon the foundational work of the open-source project ProxmoxMCP by canvrno, offering a robust and feature-rich server for managing virtual machines and containers on Proxmox platforms. This enhanced version introduces complete VM lifecycle management, extended power management features, and new container support. With a focus on production-grade security and stability, ProxmoxMCP-Plus integrates seamlessly with OpenAPI, providing 11 comprehensive REST API endpoints for virtualization management. The server is designed to be easily deployable with Docker and supports natural language VM creation, making it accessible for both developers and system administrators. The project is built with modern tools like Cline, Proxmoxer, and the MCP SDK, ensuring a secure, efficient, and user-friendly experience.

Features

  • Complete VM Lifecycle Management: Create, start, stop, reset, shutdown, and delete virtual machines with ease.
  • Extended Power Management: Start, stop, shutdown, and reset virtual machines with enhanced control.
  • New Container Support: Manage LXC containers with tools to list and monitor their status.
  • OpenAPI Integration: Provides 11 REST API endpoints for seamless integration with other applications.
  • Production-grade Security: Enhanced error handling, parameter validation, and comprehensive logging.

Usages

usage with cline desktop

{
    "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": []
        }
    }
}

Tools

  1. create_vm

    Create a new virtual machine with specified resources.

  2. start_vm

    Start a virtual machine.

  3. stop_vm

    Force stop a virtual machine.

  4. shutdown_vm

    Gracefully shutdown a virtual machine.

  5. reset_vm

    Reset (restart) a virtual machine.

  6. delete_vm

    Completely delete a virtual machine.

  7. get_containers

    List all LXC containers across the cluster.

  8. get_nodes

    Lists all nodes in the Proxmox cluster.

  9. get_node_status

    Get detailed status of a specific node.

  10. get_vms

    List all VMs across the cluster.

  11. get_storage

    List available storage pools.

  12. get_cluster_status

    Get overall cluster status and health.

  13. execute_vm_command

    Execute a command in a VM's console using QEMU Guest Agent.