OLM v1 MCP Server

A Model Context Protocol (MCP) server for Operator Lifecycle Manager (OLM) v1, providing AI assistants with the ability to interact with OLM v1 resources and migrate from OLM v0 to v1.

Overview

The OLM v1 MCP Server exposes OLM v1-specific resources and operations through the Model Context Protocol, allowing AI assistants to help users manage operators using the new OLM v1 architecture. This server provides tools for managing ClusterExtensions, ClusterCatalogs, and includes powerful migration capabilities to help users transition from OLM v0 to v1.

Features

• ClusterExtension Operations: List, get, create, update, and delete ClusterExtensions
• ClusterCatalog Operations: List and inspect ClusterCatalogs
• Migration Tools: Plan, validate, and execute migrations from OLM v0 to v1
• MCP Protocol Support: Standard stdio-based MCP communication
• Read-only Mode: Safe operation with no write capabilities by default
• Migration Validation: Pre-migration checks and dry-run capabilities

Available Tools

ClusterExtension Tools

• list_cluster_extensions: List ClusterExtensions in the cluster
• get_cluster_extension: Get detailed information about a specific ClusterExtension
• create_cluster_extension: Create a new ClusterExtension
• update_cluster_extension: Update an existing ClusterExtension (channel/version)
• delete_cluster_extension: Delete a ClusterExtension

ClusterCatalog Tools

• list_cluster_catalogs: List ClusterCatalogs in the cluster
• get_cluster_catalog: Get detailed information about a specific ClusterCatalog

Migration Tools

• plan_migration: Plan migration from OLM v0 Subscriptions to v1 ClusterExtensions
• validate_migration: Validate migration readiness and cluster state
• execute_migration: Execute the migration (with dry-run support)

Installation

From Source

git clone https://github.com/operator-framework/olmv1-mcp-server.git
cd olmv1-mcp-server
make build

Usage

Basic Usage

# Start the server (stdio mode for MCP clients)
./bin/olmv1-mcp-server

# Use a specific kubeconfig
./bin/olmv1-mcp-server --kubeconfig /path/to/kubeconfig

# Enable write operations (disabled by default for safety)
./bin/olmv1-mcp-server --read-only=false

# Enable only specific toolsets
./bin/olmv1-mcp-server --toolsets clusterextension,migration

Command Line Options

• --kubeconfig: Path to kubeconfig file (default: $HOME/.kube/config)
• --read-only: Prevent write operations (default: true)
• --toolsets: Enable specific toolsets (default: clusterextension,clustercatalog,migration)

Migration from OLM v0 to v1

This server's key feature is helping users migrate from OLM v0 (Subscriptions) to OLM v1 (ClusterExtensions).

Migration Workflow

1. Validate Migration Readiness

   validate_migration --namespace=<namespace>
   

   This checks that both OLM v0 and v1 are accessible, ClusterCatalogs are available, etc.

2. Plan the Migration

   plan_migration --namespace=<namespace>
   

   This analyzes existing Subscriptions and shows what ClusterExtensions will be created.

3. Execute Migration (Dry Run)

   execute_migration --namespace=<namespace> --dryRun=true
   

   This shows what would happen without making changes.

4. Execute Migration

   execute_migration --namespace=<namespace>
   

   This creates ClusterExtensions based on existing Subscriptions.

Migration Process

The migration process:

1. Discovers all Subscriptions in the specified namespace
2. Maps OLM v0 CatalogSources to OLM v1 ClusterCatalogs
3. Creates corresponding ClusterExtensions with appropriate settings
4. Preserves package, channel, and version information
5. Adds migration annotations for tracking

Important Notes

• Backup First: Always backup your OLM v0 resources before migration
• Test Environment: Test the migration in a non-produ

... View full README on GitHub