RekklesNA/ProxmoxMCP-Plus

해결하는 문제

ProxmoxMCP-Plus는 Proxmox VE 환경을 통합적이고 보안을 우선시하는 제어 플레인으로 제공합니다. 일반적인 운영 워크플로우인 VM 및 LXC 관리, 스냅샷, 백업 작업을 위해 수동으로 원시 API 호출, 쉘 스크립트, 사용자 정의 폴링을 조합할 필요가 없습니다.

작동 방식

이 프로젝트는 AI 클라이언트와 Proxmox VE API 사이의 중개 계층으로 작동합니다. 주로 두 가지 주요 접근 경로를 통해 기능을 공개합니다:

• MCP (Model Context Protocol): Claude Desktop, Cursor, VS Code와 같은 AI 에이전트가 자연어를 사용하여 Proxmox와 상호작용할 수 있도록 합니다.
• OpenAPI: 자동화, 대시보드, 노코드 도구를 위한 표준 HTTP 인터페이스를 제공합니다.

SQLite를 사용한 지속적인 작업 저장소를 포함하여 안정적인 job_id를 통해 비동기 Proxmox 작업을 추적할 수 있으며, 클라이언트는 작업을 풀링, 재시도, 또는 취소할 수 있습니다.

대상 사용자

• AI 에이전트 운영자: LLM 기반 에이전트를 통해 가상화 인프라를 제어하고 싶은 사용자.
• DevOps/시스템 관리자: Proxmox VE를 관리하는 전문가로, 자동화를 위한 표준 OpenAPI 브리지가 필요한 사람.
• 홈 랩 애호가: VM과 컨테이너를 통합된 작업 추적 기능으로 간편하게 관리하고 싶은 사용자.

주요 기능

• 이중 접근 경로: AI 에이전트용 네이티브 MCP와 표준 HTTP 자동화용 OpenAPI.
• 포괄적인 VM/LXC 라이프사이클: VM 및 LXC의 생성, 시작, 정지, 삭제, 스냅샷 지원.
• LXC 명령 실행: SSH 기반 컨테이너 명령 실행과 통합된 정책 제어 기능.
• 작업 지속성: 안정적인 비동기 작업 추적, 감사 기록, 재시도 기능을 갖춘 저장소.
• 보안 우선 설계: Proxmox API 토큰, Bearer 인증, TLS 검증, 도구 허용/차단 목록 지원.