proxmox-mcp

proxmox-mcp는 Proxmox VE API를 위한 안전 게이트가 적용된 로컬 stdio Model Context Protocol 서버입니다. MCP 호스트에 의해 프로세스로 실행되며, HTTP 서비스가 아니며 HTTP 엔드포인트를 노출하지 않습니다.

상태 — 현재 릴리스: v0.1.1. 공식 배포판은 GitHub Release 아카이브와 해당 SHA-256 체크섬입니다. npm 패키지는 제공되거나 게시되지 않습니다.

릴리스된 Proxmox MCP 설치

로컬 stdio 설치의 경우 체크섬이 확인된 GitHub Release 아카이브를 사용하세요:

• GitHub Release v0.1.1

• 아카이브 에셋

• 체크섬 에셋

npm 패키지는 없습니다. LobeHub Marketplace 목록은 기능을 설명하며, 로컬 설치 소스가 아닙니다. ClawHub는 공개적으로 설치 가능한 OpenClaw 래퍼/목록이 없으므로 현재 게시되지 않았습니다.

Related MCP server: mcp-server-proxmox

빠른 설치

GitHub Releases에서 v0.1.1 아카이브와 체크섬을 다운로드하고, 확인한 후 아카이브를 추출하세요. MCP 호스트가 실행될 머신에서 이 작업을 수행하세요.

curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz
curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz.sha256
shasum -a 256 -c proxmox-mcp-0.1.1.tar.gz.sha256
tar -xzf proxmox-mcp-0.1.1.tar.gz
cd proxmox-mcp-0.1.1

아카이브에는 Node.js >=22가 필요합니다. 환경 변수를 통해 자격 증명을 제공하세요. 아래 값은 실제 작동하는 자격 증명이 아닌 자리 표시자입니다.

export PROXMOX_BASE_URL='https://proxmox.example:8006'
export PROXMOX_TOKEN_ID='user@realm!token-name'
: "${PROXMOX_TOKEN_SECRET:?set PROXMOX_TOKEN_SECRET in the environment}"
./proxmox-mcp

./proxmox-mcp는 stdio 프로세스입니다. MCP 호스트에서 해당 명령어, 작업 디렉터리 및 세 가지 환경 변수를 등록하거나 구성하세요. 터미널에서 단독으로 실행하는 것만으로는 클라이언트에서 사용할 수 없습니다. 아카이브 레이아웃 및 설치 세부 정보는 GitHub Release 설치 가이드를 참조하세요.

구성

다음 환경 변수만 사용됩니다:

TLS 인증서 확인은 항상 활성화됩니다. PROXMOX_TLS_VERIFY=false는 시작 시 거부되며 사용하지 마세요. Proxmox 엔드포인트가 사설 CA를 사용하는 경우 호스트 신뢰 저장소에서 해당 CA를 신뢰하세요. 전체 정책은 구성을 참조하세요.

기능

서버는 집중된 Proxmox VE 작업 세트를 제공합니다. MCP 호스트는 연결 시 정확한 스키마와 도구 설명을 발견합니다.

도구 이름, 입력, 출력 및 노드 이름 유효성 검사 규칙은 도구 계약에 문서화되어 있습니다.

안전 모델

삭제, 사용하지 않는 디스크 제거 및 강제 중지는 복구 불가능할 수 있습니다. 대상을 신중히 검토하고 토큰에 필요한 Proxmox 권한만 부여하세요. 전체 안전 지침을 참조하세요.

OpenClaw 로컬 스킬

병합된 dev 코드베이스에는 skills/proxmox-mcp-openclaw/에 OpenClaw 스킬이 포함되어 있습니다. 이는 일반 OpenClaw 플러그인이 아닌 로컬 스킬입니다. 로컬 SKILL.md 지침을 사용하세요.

새로운 절대 대상 디렉터리를 선택하세요—대상이 이미 존재해서는 안 됩니다. 먼저 자격 증명이 없는 계획을 검사하세요:

node skills/proxmox-mcp-openclaw/scripts/install.mjs --dry-run /absolute/path/to/proxmox-mcp

셸에 세 가지 구성 변수를 내보낸 후 설치하고 등록하세요:

node skills/proxmox-mcp-openclaw/scripts/install.mjs /absolute/path/to/proxmox-mcp

설치 프로그램은 변경 불가능한 v0.1.1 릴리스와 해당 체크섬을 확인한 후 사전 점검이 성공한 경우에만 지원되는 openclaw mcp add 명령을 호출합니다. 자격 증명을 기록하거나 저장하지 않습니다.

운영 경계

• 이는 호스팅 서비스나 Proxmox 액세스 제어를 대체하는 것이 아닌 로컬 stdio MCP 통합입니다.

• 서버는 MCP 클라이언트가 도구를 호출할 때까지 Proxmox 요청을 하지 않습니다. 설치 및 문서 예제는 실제 Proxmox API를 호출하지 않습니다.

• 자격 증명을 리포지토리, 가능한 경우 셸 기록 및 공유 구성 파일에 보관하지 마세요. 최소 권한 Proxmox API 토큰을 사용하세요.

• Theorvane/proxmox-mcp GitHub Releases에서만 릴리스를 받고 아카이브를 실행하기 전에 게시된 SHA-256 체크섬을 확인하세요.

문서

• 구성

• 안전

• API 및 도구 계약

• GitHub Release 설치

• 기여하기

• 보안

확인 및 기여

기여자는 dev를 기반으로 한 이슈 번호 브랜치에서 작업하고, dev에 풀 리퀘스트를 열며, 검토된 dev만 main으로 승격합니다. GitHub Release 아카이브가 유일한 배포 채널입니다. CONTRIBUTING.md를 참조하세요.

관리자는 프로젝트에서 사용하는 동일한 로컬 확인 명령을 실행할 수 있습니다:

npm ci
npm run lint
npm run typecheck
npm test
npm run build
npm run release:archive
npm run verify:release-archive
npm run validate:docs
npm run validate:governance
npm run validate:release
npm audit --omit=dev --audit-level=high
git diff --check

라이선스

이 프로젝트는 LICENSE의 약관에 따라 라이선스가 부여됩니다.