Proxmox Safe MCP

제한된 인벤토리/상태 읽기와 두 가지 좁은 변형 클래스(허용 목록에 등록된 게스트 전원 작업 및 스냅샷 생성)만 노출하는 집중형 Proxmox MCP 서버입니다. spectrenet-mcp 커밋 2e63f009d8f4642e17398685baef0251811d6637에서 추출되었으며, 이 저장소는 자체 포함(self-contained)입니다.

알파: 테스트는 합성(synthetic)입니다. Proxmox API 호환성은 모든 릴리스에 대해 인증되지 않았습니다. 프로덕션이 아닌 인프라에서 테스트하세요.

안전 계약

• 노드 대상 작업(node_status)과 두 변형 도구 모두에 대해 노드가 명시적으로 허용 목록에 등록됩니다. 게스트 유형은 qemu와 lxc뿐이며, VMID는 양의 정수여야 합니다.

• cluster_status와 list_guests는 의도적으로 클러스터 전체 API 뷰를 반환하며 노드 허용 목록으로 필터링되지 않습니다. 전용 Proxmox API 계정/토큰의 범위를 지정하여 이러한 읽기 도구가 볼 수 있는 항목을 제한하세요.

• 전원 작업은 start, shutdown, reboot, stop뿐입니다.

• 스냅샷 이름은 1~64자의 ASCII 문자, 숫자, _ 또는 -입니다.

• 모든 변형에는 바이트 단위의 APPROVE <action> <target> 확인이 필요합니다.

• 변형 응답은 제출 영수증이지 완료 증명이 아닙니다. 반환된 UPID와 최종 상태를 별도로 확인하세요.

• 게스트/스냅샷 삭제, 호스트 전원, 스토리지 변형, 할당, 마이그레이션 또는 구성 도구는 없습니다. node_status는 의도적으로 스토리지 열거를 제외합니다.

• 응답/목록/감사 필드는 제한되어 있으며 TLS 검증이 기본적으로 활성화됩니다.

Related MCP server: ProxmoxMCP-Plus

설치 및 실행

uv sync --extra test
uv run proxmox-safe-mcp --help
uv run proxmox-safe-mcp

서버는 MCP stdio를 사용합니다. .env를 로드하지 않으므로 .env.example은 가짜 문서로만 사용하고 비밀은 슈퍼바이저 또는 비밀 관리자를 통해 주입하세요.

검증

uv sync --locked --extra test
uv run --locked pytest
uv run --locked python -m compileall -q src tests
uv build

아키텍처 및 운영 및 보안 세부 사항을 참조하세요. MIT © 2026 Ben Gauger.