Declarative API를 제공하는 쿠버네티스 운영자는 MCP Server를 배포, 관리, 안전하게 구출하고 생산 등급 자동화 및 생태계 통합을 통해 전체 수명주기를 처리합니다.

주: 이 프로젝트는 현재 ** 베타** (v1beta1)입니다. API 및 행동은 향후 릴리스에서 변경할 수 있습니다.

문서

• 소개 - 아키텍처 및 MCPServer API 개요
• Quickstart 가이드 - 빠르고 실행
• Gateway Integration - 외부 게이트웨이를 통해 MCP 서버를 노출
• 미터 - Prometheus 미터 참조
• TLS 구성 - Min version, cipher suite, TLS 1.3 그룹 이름
• 저장 버전 마이그레이션 - v1alpha1를 제거하기 전에 v1beta1에 저장 개체를 다시 쓰기
• API Reference - 전체 MCPServer API 문서
• MCPServer 예제 완료 - 모든 사용 가능한 필드를 보여주는 YAML
• 기여 - 프로젝트에 기여하는 방법

필수품

• 쿠버네티스 클러스터 (v1.28+)
• 클러스터에 접근하기 위한 kubectl

빠른 시작

##1. 연산자 설치

옵션 A: 릴리스에서 설치 (추천)

최신 릴리스에서 연산자와 CRD를 직접 설치:

mcp-lifecycle-operator

A Kubernetes operator that provides a declarative API to deploy, manage, and safely roll out MCP Servers, handling their full lifecycle with production-grade automation and ecosystem integrations.

Note: This project is currently in beta (v1beta1). APIs and behavior may change in future releases.

Documentation

• Introduction - Architecture and MCPServer API overview
• Quickstart Guide - Get up and running quickly
• Gateway Integration - Expose MCP servers through external gateways
• Metrics - Prometheus metrics reference
• TLS Configuration - Min version, cipher suites, and TLS 1.3 named groups
• Storage Version Migration - Rewrite stored objects to v1beta1 before removing v1alpha1
• API Reference - Full MCPServer API documentation
• Complete MCPServer example - YAML showing all available fields
• Contributing - How to contribute to the project

Prerequisites

• Kubernetes cluster (v1.28+)
• kubectl configured to access your cluster

Quick Start

1. Install the Operator

Option A: Install from Release (Recommended)

Install the operator and CRDs directly from the latest release:

kubectl apply -f https://github.com/kubernetes-sigs/mcp-lifecycle-operator/releases/latest/download/install.yaml

This installs the CRDs, the controller Deployment, and all necessary RBAC resources in the mcp-lifecycle-operator-system namespace.

Option B: Run Locally (for Development)

Clone the repository and run the controller on your local machine:

make install  # Install the CRDs
make run      # Run the controller locally

Keep this terminal open. The controller logs will appear here.

Option C: Build and Deploy from Source

Build and deploy the controller as a Deployment in your cluster:

# Build and push the container image for multiple platforms
make docker-buildx IMG=/mcp-lifecycle-operator:latest

# Deploy to cluster
make deploy IMG=/mcp-lifecycle-operator:latest

Note: docker-buildx builds for multiple architectures (amd64, arm64, s390x, ppc64le) and pushes automatically.

2. Create a Test MCPServer

In a new terminal, create a test MCPServer resource:

kubectl apply -f - <<EOF
apiVersion: mcp.x-k8s.io/v1beta1
kind: MCPServer
metadata:
  name: test-server
  namespace: default