Multi-Cluster MCP server

@yanmxa

About Multi-Cluster MCP server

The gateway for GenAI systems to interact with open-cluster-management through the MCP

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "multicluster-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "multicluster-mcp-server@latest"
      ]
    }
  }
}

Tools

Retrieves a list of Kubernetes clusters (also known as managed clusters or spoke clusters).

Generates the KUBECONFIG for the managed cluster and binds it to the specified ClusterRole (default: cluster-admin).

Securely run a kubectl command or apply YAML. Provide either 'command' or 'yaml'.

Overview

What is Multi-Cluster MCP server?

Multi-Cluster MCP server is a Model Context Protocol (MCP) gateway that lets Generative AI systems interact with multiple Kubernetes clusters. It uses Open Cluster Management to perform operations on Kubernetes resources, manage multi-cluster environments, and deliver cluster observability.

How to use Multi-Cluster MCP server?

Configure the server in your MCP client using the JSON snippet with npx -y multicluster-mcp-server@latest. Ensure kubectl is installed and that the KUBECONFIG environment variable points to the hub cluster. The server accesses managed clusters through the hub cluster.

Key features of Multi-Cluster MCP server

Retrieve resources from the hub cluster (current context)
Retrieve resources from managed clusters
Connect to a managed cluster using a specified ClusterRole
Access resources across multiple Kubernetes clusters via Open Cluster Management
Retrieve and analyze metrics, logs, and alerts from integrated clusters
Interact with multi-cluster APIs, including Managed Clusters, Policies, and Add-ons

Use cases of Multi-Cluster MCP server

AI-driven troubleshooting across a fleet of Kubernetes clusters
Automated multi-cluster resource inspection and reporting
Centralized observability data retrieval for GenAI analysis
Policy and compliance checks across managed clusters

FAQ from Multi-Cluster MCP server

What prerequisites are needed to run the server?

You must have kubectl installed and the KUBECONFIG environment variable set to access the hub cluster.

How does the server access managed clusters?

It treats the configured cluster as the hub cluster and accesses managed clusters through it, optionally using a specified ClusterRole for connection.

Does the server support prompt templates or MCP resources?

Prompt templates and MCP resources for Open Cluster Management are currently in the planning stage and not yet available.

How do I configure the server in my MCP client?

Use the following JSON snippet:

{
  "mcpServers": {
    "multicluster-mcp-server": {
      "command": "npx",
      "args": ["-y", "multicluster-mcp-server@latest"]
    }
  }
}

What license is the server distributed under?

This project is licensed under the MIT License.

Frequently asked questions

What prerequisites are needed to run the server?

You must have `kubectl` installed and the `KUBECONFIG` environment variable set to access the hub cluster.

How does the server access managed clusters?

It treats the configured cluster as the hub cluster and accesses managed clusters through it, optionally using a specified `ClusterRole` for connection.

Does the server support prompt templates or MCP resources?

Prompt templates and MCP resources for Open Cluster Management are currently in the planning stage and not yet available.

How do I configure the server in my MCP client?

Use the following JSON snippet: ```json { "mcpServers": { "multicluster-mcp-server": { "command": "npx", "args": ["-y", "multicluster-mcp-server@latest"] } } } ```

What license is the server distributed under?

This project is licensed under the MIT License.

Comments

Basic information

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.