vcenter-mcp

Claude Code 및 기타 MCP 클라이언트에 VMware vCenter / ESXi VM 수명 주기 도구를 노출하는 Model Context Protocol 서버입니다. pyVmomi를 기반으로 구축되었습니다.

기능

• vCenter 데이터센터(호스트별 그룹화) 또는 독립형 ESXi 호스트의 VM 나열

• VM 생성 (네트워크 부팅 우선; 씬 또는 씩 프로비저닝; ESXi 타겟용 중첩 가상화 옵션)

• VM 전원 켜기 및 끄기

• VM 삭제 (실행 중인 경우 먼저 전원을 끄고 디스크에서 삭제)

조회 시 표시 이름 또는 moref ID(예: vm-42)를 사용할 수 있습니다. moref 경로를 사용하면 인벤토리 스캔을 건너뛰어 대규모 환경에서 더 빠르게 작동합니다.

사전 요구 사항

• Python 3.10 이상

• 네트워크를 통해 연결할 수 있는 vCenter Server 또는 독립형 ESXi 호스트

• 수행하려는 작업에 필요한 권한이 있는 vSphere 계정 (list_vms에는 읽기 전용으로 충분하며, 생성/삭제에는 해당 VM 및 리소스 풀 권한이 필요함)

설치

프로젝트 로컬 virtualenv에 설치하십시오. venv를 사용하면 vcenter-mcp와 그 종속성(특히 pyVmomi)을 시스템 Python과 격리된 상태로 유지할 수 있습니다.

이 저장소를 복제한 후:

python3 -m venv .venv
.venv/bin/pip install --upgrade pip
.venv/bin/pip install -e .

개발용(pytest도 설치됨):

.venv/bin/pip install -e ".[dev]"

이 README 전체에서 명령어는 .venv/bin/...을 사용합니다. 셸당 한 번 source .venv/bin/activate를 실행하고 접두사를 생략해도 동일한 결과가 나옵니다.

타겟 구성

venv의 Python을 사용하여 대화형 설정을 실행하십시오:

.venv/bin/python -m vcenter_mcp setup

다음 항목을 입력하라는 메시지가 표시됩니다:

1. 타겟 이름(예: lab-vcenter) — 나중에 이 타겟을 참조하는 데 사용됨

2. vCenter / ESXi의 호스트 또는 IP

3. 사용자 이름 및 비밀번호

4. 타겟 유형: vcenter 또는 esxi

5. (vCenter만 해당) 데이터센터 및 클러스터 이름

6. 데이터스토어 이름

7. 하나 이상의 네트워크 프로필(이름과 하나 이상의 포트 그룹 이름으로 구성)

설정은 ~/.config/vcenter-mcp/config.json (모드 0600)에 구성을 작성합니다. 언제든지 다시 실행하여 다른 타겟을 추가하거나 기존 타겟을 업데이트할 수 있습니다.

구성 파일 형식

{
  "default_target": "lab-vcenter",
  "targets": {
    "lab-vcenter": {
      "host": "vcenter.lab.example.com",
      "user": "admin@vsphere.local",
      "password": "...",
      "type": "vcenter",
      "datacenter": "Lab DC",
      "cluster": "Lab Cluster",
      "datastore": "datastore1",
      "networks": {
        "standard": ["VM Network"],
        "secure-boot": ["pg-secure-1", "pg-secure-2"]
      },
      "default_network": "standard"
    }
  },
  "templates": {
    "esxi":   { "cpu": 4, "ram_mb": 16384, "disk_gb": 100, "disk_provisioning": "thin", "guest_id": "vmkernel7Guest", "vhv": true },
    "ubuntu": { "cpu": 2, "ram_mb": 4096,  "disk_gb": 40,  "disk_provisioning": "thin", "guest_id": "ubuntu64Guest",  "vhv": false },
    "rhel":   { "cpu": 2, "ram_mb": 4096,  "disk_gb": 40,  "disk_provisioning": "thin", "guest_id": "rhel9_64Guest",  "vhv": false }
  }
}

네트워크 프로필은 포트 그룹의 목록입니다. 첫 번째 항목이 부팅 NIC가 됩니다. 고유한 VM 유형을 추가하려면 templates에 항목을 추가하십시오. create_vm에 전달된 vm_type 문자열이 이 딕셔너리와 일치하게 됩니다.

Claude Code에 등록

절대 경로를 사용하여 venv의 Python으로 MCP 서버를 등록하십시오. Claude Code는 활성화된 venv를 상속하지 않는 새로운 셸에서 서버를 시작하므로 절대 경로가 필요합니다. 여기에 일반 python을 지정하면 vcenter_mcp를 가져오지 못합니다.

VCENTER_MCP_DIR="$(pwd)"   # run this from the repo root, after install
claude mcp add --scope user vcenter -- "$VCENTER_MCP_DIR/.venv/bin/python" -m vcenter_mcp

또는 원하는 절대 경로를 직접 입력하십시오:

claude mcp add --scope user vcenter -- /absolute/path/to/vcenter-mcp/.venv/bin/python -m vcenter_mcp

읽기 도구(list_vms)는 프롬프트 없이 허용해도 안전합니다. ~/.claude/settings.json의 permissions.allow에 추가하십시오:

{
  "permissions": {
    "allow": [
      "mcp__vcenter__list_vms"
    ]
  }
}

파괴적인 도구(create_vm, power_on_vm, power_off_vm, delete_vm)는 기본 허용 목록에 포함되어 있지 않으므로 Claude가 호출할 때마다 사용자에게 확인을 요청합니다.

도구

TLS 관련 참고 사항

vcenter-mcp는 검증되지 않은 SSL 컨텍스트로 연결합니다. 이는 랩 vCenter가 자체 서명된 인증서를 사용하는 경우가 매우 많기 때문에 govc 및 대부분의 pyVmomi 샘플 코드에서 사용하는 기본값과 동일합니다. 타겟이 적절하게 서명된 인증서를 사용하고 실제 검증을 원한다면 src/vcenter_mcp/client.py에서 _ssl_context()를 교체하십시오.

개발

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest

테스트는 CI에서 Python 3.10, 3.11, 3.12로 실행됩니다(.github/workflows/test.yml 참조).

라이선스

Apache-2.0