vcf-ops-mcp

VCF Operations(vROPs) suite-api REST API를 래핑하는 MCP 서버입니다. 리소스, 메트릭, 알림을 MCP 도구로 노출해여 LLM 클라이언트가 모니터링 대항 인프라를 직접 조회할 수 있게 합니다.

설정

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env   # then fill in your VCF Operations details

필수 구성(. envV 또는 실체 환경 변수를 사용):

서버는 첫 사용하게 때 /suite-api/api/auth/token/acquireor에서 토큰을 획득하여 캐시하고, 토큰이 만료에 가까워지거나 401로 거부되면 자동으로 다시 획득합니다.

서버의 전송/인증 구성 (다른 네변수들 마찬가지로 .env 또는 실제 환경 변수를 사용):

실행

기본적으로 이 서버는 streamable-http를 통한 스탠드얼론 원격 서버 로 실행되고 127.0.0.1:8000(포트)에 당대치며, 모톤 요청에 Bearer 토큐을 요구합니다:

export VCFOPS_MCP_BEARER_TOKEN="$(openssl rand -hex 32)"
vcf-ops-mcp
# or
python -m vcf_ops_mcp

GET /healthz는 인증도지 않고 접(이 가능합니다 (라이언스 밸런서/오케스트레이터의 실기 확인). 그 밖의 모든 요청는 Bearer 토큐이 필요합니다. 127.0.00.1은 로컬에서만 “수신”하므로, 다른 호스트에서 실재로 그 주소에 접속하려면 VCFOPS_MCP_HOST=0.0.0.0을 (기본값) 사용 또는 리서스 프록시 뒤에 서버를 실행하세요. 그리고 Bearer 토큐이 네트워크와 모니터 전체 환경을 조회할 수 있는 자격 증명 사이의 유일한 장기라고 확실히 하세요. 이 토큐을 모든 기타 기타비밀값과 같이 취급하고, 신할 수 없는 네트워크에서는 평문 HTTP보다 인증된 TLS 종료(예: 리버스 프록시)를 우선위적으로 두십시오.

VCFOPS_MCP_HOST가 127.0.0.1/localhost이 아닌 경우, FastMCP의 DNS-리바인딩 보호(들어오는 Host 헤더를 검사하는)는 기본적으로 아무것도 허용하지 않습니다. FastMCP는 프백 호스트에서만 허용 목록을 자동 생성하기 때문입니다합니다. 그 값을 설후하지 않으면 Host 헤더 검증이 수행되지 않으므로 Bearer 토큐만이 유일한 진입 장벽이 됩니다. 신할 수 있는 네트워크에서는 문제없지만, 공유되거나 신룰할 수 없는 네트워크에서는 방송 층십이 다양(view) 확실히 하기 위해, 클라이언트가 실·제로 접속하는 호스트 네임/IP:포트 목록(파이로 구분)을 VCFOPS_MCP_ALLOWED_HOSTS`에 설하세요.

Point anMCP 클라이언트가 streamable-http 서버와 연결 시키고 싶다면 예를 들어, Claude Code에서 다음과 같 식으로 접속합시다:

claude mcp add --transport http vcf-operations http://<host>:8000/mcp \
  --header "Authorization: Bearer <your-token>"

stdio로 실행하는 대안

로컬에서 MCAP 클라이언트가 서버를 직(하위) 프로세스로 생성하는 경우 (네트워크 노출이 필요 없음) VCFOPS_MCP_TRANSPORT=stdio 설정하면 됩니다. 이 도으드에서는 Bearer 토큐이 필요하지 않습니다. Claude Desktop 구성의 예시:

{
  "mcpServers": {
    "vcf-operations": {
      "command": "/absolute/path/to/.venv/bin/vcf-ops-mcp",
      "env": {
        "VCFOPS_MCP_TRANSPORT": "stdio",
        "VCFOPS_BASE_URL": "https://ops.example.com",
        "VCFOPS_USERNAME": "admin",
        "VCFOPS_PASSWORD": "changeme"
      }
    }
  }
}

도구

리소스

• list_resources — 모니터링 대체를 이름/어터 유형/리소스 유형/상태(health)별로 검색

• get_resource — 한 개 리소스에 대한 완전한 상세 정보

• get_resource_properties — 수집된 구성 속성 정보

• get_resource_relationships — 상부/하부 개체 정보

메트릭

• list_metric_keys — 어터-리소스 유형에 사할 수 있는 스텟키의 목록

• get_latest_stats — 지정 리소의 가장 최근 측성 치

• query_stats — 여러 리소에 걸처 과거 statisttic 시리즈 쿄리 및 rollup/interval 설정

알림

• list_alert — 앙티브/모든 알림을 조회 (옵션: 특정 리소 또는 중임도로 필터링)

• get_alert — 한 알림의 완전한 상세 정보

• list_alert_definitions — 알림 뒤에 있는 규칙 정의 목록

테스트

테스트는 respx를 사용해여 VCFS 연동을 모방(mock)합니다 — 실제 인스턴스가 필요 없습니다.

pip install -e ".[dev]"
pytest

참고

mcp<2.0.0버전에 고정: MCP SDK의 2.x라인은 FastMCP를 MCPserver로 이름을 변경하고 mcp.server.mCP로 이동했습니다. 이 프로엑트는 잘 정립환 1.x mcp.server.fastmcp.fastmcp API를 대상으로 합니다.