ESXi MCP 서버

MCP(Model Control Protocol) 기반의 VMware ESXi/vCenter 관리 서버로, 가상 머신 관리를 위한 간단한 REST API 인터페이스를 제공합니다.

특징

• ESXi 및 vCenter Server 연결 지원

• SSE(Server-Sent Events) 기반 실시간 통신

• JSON-RPC를 지원하는 RESTful API 인터페이스

• API 키 인증

• 완벽한 가상 머신 수명 주기 관리

• 실시간 성능 모니터링

• SSL/TLS 보안 연결 지원

• 유연한 구성 옵션(YAML/JSON/환경 변수)

Related MCP server: vSphere MCP Server

핵심 기능

• 가상 머신 관리

  • VM 생성

  • VM 복제

  • VM 삭제

  • 전원 켜기/끄기 작업

  • 모든 VM 나열

• 성능 모니터링

  • CPU 사용량

  • 메모리 사용량

  • 저장 공간 사용량

  • 네트워크 트래픽 통계

요구 사항

• 파이썬 3.7 이상

• 파이브모미

• PyYAML

• 유비콘

• mcp-core(머신 제어 프로토콜 코어 라이브러리)

빠른 시작

1. 종속성 설치:

지엑스피1

2. 구성 파일 config.yaml 생성합니다.

vcenter_host: "your-vcenter-ip"
vcenter_user: "administrator@vsphere.local"
vcenter_password: "your-password"
datacenter: "your-datacenter"        # Optional
cluster: "your-cluster"              # Optional
datastore: "your-datastore"          # Optional
network: "VM Network"                # Optional
insecure: true                       # Skip SSL certificate verification
api_key: "your-api-key"             # API access key
log_file: "./logs/vmware_mcp.log"   # Log file path
log_level: "INFO"                    # Log level

3. 서버를 실행합니다:

python server.py -c config.yaml

API 인터페이스

입증

모든 특권 작업에는 먼저 인증이 필요합니다.

POST /sse/messages
Authorization: Bearer your-api-key

주요 도구 인터페이스

1. VM 생성

{
    "name": "vm-name",
    "cpu": 2,
    "memory": 4096,
    "datastore": "datastore-name",
    "network": "network-name"
}

2. VM 복제

{
    "template_name": "source-vm",
    "new_name": "new-vm-name"
}

3. VM 삭제

{
    "name": "vm-name"
}

4. 전력 운영

{
    "name": "vm-name"
}

리소스 모니터링 인터페이스

VM 성능 데이터 가져오기:

GET vmstats://{vm_name}

구성

환경 변수

모든 구성 항목은 다음 명명 규칙에 따라 환경 변수 설정을 지원합니다.

• VCENTER_HOST

• VCENTER_USER

• VCENTER_PASSWORD

• VCENTER_DATACENTER

• VCENTER_CLUSTER

• VCENTER_DATASTORE

• VCENTER_NETWORK

• VCENTER_INSECURE

• MCP_API_키

• MCP_LOG_FILE

• MCP_LOG_LEVEL

보안 권장 사항

1. 프로덕션 환경:

   • 유효한 SSL 인증서를 사용하세요

   • API 키 인증 활성화

   • 적절한 로그 수준 설정

   • API 접근 범위 제한

2. 테스트 환경:

   • SSL 검증을 건너뛰려면 안전하지 않음을 true로 설정합니다.

   • 더 자세한 로그 수준(DEBUG)을 사용하세요

특허

MIT 라이센스

기여하다

이슈와 풀 리퀘스트를 환영합니다!

변경 사항

v0.0.1

• 최초 출시

• 기본 VM 관리 기능

• SSE 커뮤니케이션 지원

• API 키 인증

• 성능 모니터링

작가

브라이트8192

감사의 말

• VMware pyvmomi 팀

• MCP 프로토콜 개발팀