vsphere-mcp

VMware vSphere / vCenter 운영을 위한 MCP(Model Context Protocol) 서버입니다.

Claude Code를 사용하여 자연어로 vSphere 인프라를 운영하세요.

참고: 모든 개발 및 테스트는 vcsim(vCenter Server Simulator)을 대상으로 수행됩니다. 상용 vSphere 환경은 필요하지 않으며 영향을 받지 않습니다.

기능

• list_vms - 모든 가상 머신 나열 (호스트/클러스터별 필터링)

• get_vm_info - 상세 VM 정보 가져오기 (CPU, 메모리, 디스크, NIC, 스토리지)

• list_hosts - 모든 ESXi 호스트 나열 (클러스터별 필터링)

더 많은 도구가 곧 추가될 예정입니다 (전원 작업, 스냅샷, vMotion 등).

빠른 시작

1. vcsim 시작

docker compose up -d

2. 설치

uv pip install -e .

3. Claude Code에 등록

claude mcp add --transport stdio vsphere-mcp \
  --env VSPHERE_HOST=localhost \
  --env VSPHERE_PORT=8989 \
  --env VSPHERE_USER=user \
  --env VSPHERE_PASSWORD=pass \
  --env VSPHERE_IGNORE_SSL=true \
  -- uv run vsphere-mcp

환경 변수

개발

테스트 실행 (vcsim 실행 필요)

docker compose up -d
uv run pytest -v

린트(Lint)

uv run ruff check src/ tests/

라이선스

Apache License 2.0