OCP MCP Server (mcp-ocp)

OpenShift Container Platform (OCP) 클러스터와 연동하여 LLM이 클러스터의 상태를 진단하고 리소스를 제어할 수 있게 도와주는 Model Context Protocol (MCP) 서버입니다.

기능 (MCP Tools)

이 서버는 범용 리소스 제어(CRUD) 도구와 장애 진단 및 모니터링을 위한 유형별 특화 조회 도구를 모두 제공합니다.

1. 범용 CRUD 도구 (crud-tools)

YAML 형식의 데이터를 파싱하여 클러스터 내 거의 모든 리소스 종류를 유연하게 통제할 수 있습니다.

• ocp_create_resource: YAML 내용을 파싱하여 리소스를 생성 (CREATE)
• ocp_read_resource: 특정 리소스의 상세 메타데이터와 스펙을 JSON/YAML 덤프 형태로 반환 (READ)
• ocp_update_resource: YAML 내용을 통해 리소스 전체 업데이트 (UPDATE/PUT)
• ocp_delete_resource: 특정 리소스 삭제 (DELETE)

2. 장애 진단 및 상태 조회 도구 (Troubleshooting)

• ocp_list_events: 네임스페이스 내 쿠버네티스 이벤트 이력 조회 (CrashLoopBackOff, Pending 등의 원인 파악)
• ocp_list_nodes: 클러스터 내 노드 상태 및 자원 압박(Pressure) 파악
• ocp_get_cluster_operators: OpenShift 핵심 오퍼레이터들의 상태 (Available, Degraded) 점검

3. 유형별 워크로드 및 네트워크 조회

• Workloads: ocp_list_pods (재시작 횟수 포함 반환), ocp_get_pod_logs, ocp_list_deployments, ocp_list_statefulsets, ocp_list_daemonsets
• Networking: ocp_list_services, ocp_list_routes
• Config & Storage: ocp_list_configmaps, ocp_list_pvcs
• OpenShift 특화: ocp_list_projects, ocp_list_buildconfigs, ocp_list_imagestreams

참고: 모든 도구와 파라미터 설명은 **한국어(KR)와 영어(EN)**가 병기되어 있습니다.

환경 변수

• OCP_URL: OCP 클러스터 API 주소 (예: https://api.ocp.example.com:6443)
• OCP_TOKEN: API 인증용 Bearer 토큰 (필수)
• PORT: HTTP 서버 포트 (기본값: 3000)
• TRANSPORT: http 또는 sse 설정 시 HTTP 서버 구동 (미설정 시 stdio)
• NODE_TLS_REJECT_UNAUTHORIZED: 사설 인증서를 사용하는 경우 0으로 설정

실행 방법

로컬 실행 (npx)

{
  "mcpServers": {
    "ocp-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-ocp"],
      "env": {
        "OCP_URL": "https://api.ocp.example.com:6443",
        "OCP_TOKEN": "your-bearer-token",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

(참고: NPM 패키지 스코프가 붙었을 경우 @itapi-core/mcp-ocp로 사용할 수 있습니다.)