rekklesna/proxmoxmcp-plus

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

628 stars 101 forks 품질 92 트렌드 44MIT

Repository Install

rekklesna/proxmoxmcp-plus는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

rekklesna/proxmoxmcp-plus는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

MCP 클라이언트, AI 에이전트, OpenAPI 툴을 통해 하나의 보안에 민감한 제어 플레인을 통해 VM, LXC, 스냅샷, 백업, ISO, 컨테이너 명령어, 그리고 지속 실행 중인 장기 작업을 위한 Proxmox VE를 운영할 수 있습니다.

퀵 스타트 | 클라이언트 설치 | 데모 | 도구 | 안전 | 시나리오 | 문서 | 위키

MCP와 OpenAPI는 동일한 워크플로우에 접근할 수 있는 대안적 진입 지점이며, 별도의 프로세스에서 실행됩니다. 실선 화살표는 요청과 실행을 나타냅니다; 점선 화살표는 지속된 작업 및 감사 상태를 표시합니다. 승인 게이트, SSH 실행 및 MCP HTTP OAuth는 구성에 따라 다릅니다. 도표를 선택하여 전체 크기로 확인하세요.

왜 ProxmoxMCP-Plus인가

ProxmoxMCP-Plus는 AI 클라이언트와 Proxmox VE 사이에 위치하여, 운영자가 모든 워크플로우에 대해 원시 API 호출, 일회성 셸 스크립트, 맞춤형 작업 폴링을 직접 연결하지 않아도 됩니다.

동일한 작동 표면을 두 가지 방식으로 노출시킵니다:

MCP 클로드 데스크톱, 커서, VS 코드, Open WebUI, Codex 및 기타 MCP 지원 에이전트를 위한
OpenAPI HTTP 자동화, 대시보드, 내부 도구, 코드 없는 워크플로우

제공되는 것:

VM 및 LXC 라이프사이클 작업
스냅샷 생성, 롤백, 삭제
백업 및 복원 워크플로우

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

ProxmoxMCP-Plus

Operate Proxmox VE from MCP clients, AI agents, and OpenAPI tooling through one security-conscious control plane for VMs, LXCs, snapshots, backups, ISOs, container commands, and persistent long-running jobs.

MCP and OpenAPI are alternative entry points into the same workflows and may run in separate processes. Solid arrows show requests and execution; dashed arrows show persisted job and audit state. Approval gates, SSH execution and MCP HTTP OAuth depend on configuration. Select the diagram to view it at full size.

Why ProxmoxMCP-Plus

ProxmoxMCP-Plus sits between AI clients and Proxmox VE so operators do not have to stitch together raw API calls, one-off shell scripts, and custom job polling for every workflow.

It exposes the same operational surface in two ways:

MCP for Claude Desktop, Cursor, VS Code, Open WebUI, Codex, and other MCP-capable agents
OpenAPI for HTTP automation, dashboards, internal tools, and no-code workflows

What you get:

VM and LXC lifecycle actions
snapshot create, rollback, and delete
backup and restore workflows
ISO download and cleanup
node, storage, and cluster inspection
SSH-backed container command execution with guardrails
opt-in guarded Proxmox node SSH commands
persistent job tracking for async Proxmox tasks

What Makes It Different

GitHub에서 전체 README 보기

설치

uvx proxmox-mcp-plus

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": ["proxmox-mcp-plus"],
      "env": {
        "PROXMOX_HOST": "your-proxmox-host",
        "PROXMOX_USER": "root@pam",
        "PROXMOX_TOKEN_NAME": "mcp-token",
        "PROXMOX_TOKEN_VALUE": "your-token-secret",
        "PROXMOX_PORT": "8006",
        "PROXMOX_VERIFY_SSL": "true"
      }
    }
  }
}