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.
What is MCP Lifecycle Operator?
MCP Lifecycle Operator is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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.
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.
This server falls under the Cloud Services and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Kubernetes operator that provides a declarative API to dep
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-lifecycle-operatorConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Lifecycle Operator
MCP Lifecycle Operator is a Kubernetes operator (under kubernetes-sigs) that provides a declarative API for deploying and managing MCP servers on Kubernetes clusters. It introduces an MCPServer custom resource (API version mcp.x-k8s.io/v1alpha1) that automates the full lifecycle of MCP server workloads — from deployment and health checking to service discovery and Prometheus metrics exposure. Platform teams can use it to safely roll out production-grade MCP server infrastructure with GitOps-compatible declarative configuration instead of managing raw Deployments and Services manually.
Prerequisites
- Kubernetes cluster v1.28 or newer with kubectl configured
- Cluster admin permissions to install CRDs and deploy the operator
- Go 1.26+ if building from source or running locally
- An MCP-compatible client to connect to the managed MCP servers
Install the operator from the latest release
Apply the official install manifest to deploy the operator and its CRDs into your cluster in a single command.
kubectl apply -f https://github.com/kubernetes-sigs/mcp-lifecycle-operator/releases/latest/download/install.yamlVerify the operator is running
Check that the operator pod is running before creating any MCPServer resources.
kubectl get pods -n mcp-lifecycle-operator-systemCreate an MCPServer resource
Define an MCPServer custom resource pointing to your MCP server container image. The operator will create the Deployment and Service automatically.
apiVersion: mcp.x-k8s.io/v1alpha1
kind: MCPServer
metadata:
name: my-mcp-server
spec:
source:
type: ContainerImage
containerImage:
ref: quay.io/containers/kubernetes_mcp_server:latest
config:
port: 8080Apply the manifest
Apply the MCPServer manifest to your cluster and watch the operator provision the workload.
kubectl apply -f my-mcp-server.yaml
kubectl get mcpserver my-mcp-server -o yamlTest connectivity to the managed MCP server
Port-forward to the auto-generated Service and verify the health and MCP endpoints are reachable.
kubectl port-forward service/my-mcp-server 8080:8080
curl http://localhost:8080/healthz
curl http://localhost:8080/mcpMonitor operator metrics
The operator exposes Prometheus metrics from a dedicated endpoint for observability into MCPServer resource lifecycle events.
kubectl get service -n mcp-lifecycle-operator-systemMCP Lifecycle Operator Examples
Client configuration
Connect an MCP client to a server managed by the operator via port-forwarding or a cluster-internal URL discovered from the MCPServer status.
{
"mcpServers": {
"k8s-mcp": {
"command": "kubectl",
"args": ["port-forward", "service/my-mcp-server", "8080:8080"]
}
}
}Prompts to try
Use natural language to interact with MCP servers deployed and managed by the operator.
- "Check the health status of the MCP server running in the default namespace."
- "List all MCPServer resources currently deployed in the cluster."
- "Show me the readiness conditions for my-mcp-server."
- "What is the cluster-internal URL for the MCP server service?"Troubleshooting MCP Lifecycle Operator
MCPServer resource stuck in non-Ready state
Inspect the MCPServer status conditions with 'kubectl describe mcpserver <name>' and check operator logs with 'kubectl logs -n mcp-lifecycle-operator-system deploy/mcp-lifecycle-operator-controller-manager'. The Accepted and Ready conditions will indicate the specific failure reason.
CRDs not found after installing the operator
Verify the install.yaml applied successfully and that you have cluster-admin permissions. Run 'kubectl get crd | grep mcp' to confirm the mcp.x-k8s.io CRDs are registered.
Container image cannot be pulled
Ensure the container image reference in spec.source.containerImage.ref is accessible from your cluster's node pull credentials. Use an ImagePullSecret if the registry requires authentication.
Frequently Asked Questions about MCP Lifecycle Operator
What is MCP Lifecycle Operator?
MCP Lifecycle Operator is a Model Context Protocol (MCP) server that 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. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Lifecycle Operator?
Follow the installation instructions on the MCP Lifecycle Operator GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Lifecycle Operator?
MCP Lifecycle Operator works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Lifecycle Operator free to use?
Yes, MCP Lifecycle Operator is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
MCP Lifecycle Operator Alternatives — Similar Cloud Services Servers
Looking for alternatives to MCP Lifecycle Operator? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.
Open WebUI
★ 138.2kUser-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Anything LLM
★ 60.4kThe all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.
LocalAI
★ 46.4kLocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.
Nacos
★ 33.0kan easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
Xiaozhi ESP32
★ 26.7k本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.
Gateway
★ 11.8kA blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.
Browse More Cloud Services MCP Servers
Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Lifecycle Operator in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Lifecycle Operator?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.