https://github.com/yanmxa/multicluster-mcp-server

The gateway for GenAI systems to interact with open-cluster-management through the MCP
https://github.com/yanmxa/multicluster-mcp-server

Last synced: 4 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/yanmxa/multicluster-mcp-server
• Owner: yanmxa
• Created: 2025-02-28T07:54:26.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-08T12:07:08.000Z (11 months ago)
• Last Synced: 2025-12-15T02:15:04.882Z (6 months ago)
• Language: Python
• Homepage:
• Size: 1.15 MB
• Stars: 4
• Watchers: 1
• Forks: 5
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-mcp-servers - Multicluster MCP Server - An MCP server that acts as a gateway for GenAI systems to interact with multiple Kubernetes clusters, enabling management and operations across clusters via the Model Context Protocol. ([Read more](/details/multicluster-mcp-server.md)) `kubernetes` `cluster-management` `cloud-native` (Cloud & Devops Mcp Servers)
• awesome-mcp-servers - Multicluster-MCP-Sever - An MCP gateway to interact with multiple Kubernetes clusters from a single endpoint. (Community Servers)
• awesome-mcp-servers - **multicluster-mcp-server** - The gateway for GenAI systems to interact with open-cluster-management through the MCP `python` `mcp` `ai` `http` `kubernetes` `pip install git+https://github.com/yanmxa/multicluster-mcp-server` (🤖 AI/ML)
• toolsdk-mcp-registry - ✅ multicluster-mcp-server - cluster environments for managing distributed resources through kubectl commands, service account connections, and seamless cross-cluster operations without switching contexts. (4 tools) (node) (Cloud Platforms / How to Submit)
• metorial-index - Multi-Cluster MCP Server - Manage multiple Kubernetes clusters, interact with them using `kubectl` commands, and gain insights through observability features. Streamline operations and manage Kubernetes resources across clusters seamlessly. (Task and Project Management)
• awesome-mcp-servers - MultiCluster MCP Gateway - The gateway for GenAI systems to interact with multiple Kubernetes clusters through the MCP (Table of Contents / System Automation)
• awesome-devops-mcp - yanmxa/multicluster-mcp-server - Gateway for GenAI systems to interact with multiple Kubernetes clusters (🐳 Kubernetes & Containers)
• awesome-claude-dxt - yanmxa/multicluster-mcp-server - The gateway for GenAI systems to interact with multiple Kubernetes clusters. (🗂️ Extensions by Category / ⚙️ Development Tools)

README

          

# Open Cluster Management MCP Server

The **OCM MCP Server** provides a robust gateway for Generative AI (GenAI) systems to interact with multiple Kubernetes clusters through the Model Context Protocol (MCP). It facilitates comprehensive operations on Kubernetes resources, streamlined multi-cluster management, and delivered interactive cluster observability.

## **🚀 Features**

### 🛠️ MCP Tools - Kubernetes Cluster Awareness

  

- ✅ Retrieve resources from the **hub cluster** (current context)  

- ✅ Retrieve resources from the **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, Add-ons, and more

  ![alt text](images/tools.png)

  

  Mutiple Kubernetes Clusters Operations

  [![Watch the demo](https://asciinema.org/a/706281.svg)](https://asciinema.org/a/706281)

  

### 📦 Prompt Templates for Open Cluster Management *(Planning)*

- Provide reusable prompt templates tailored for OCM tasks, streamlining agent interaction and automation

### 📚 MCP Resources for Open Cluster Management *(Planning)*

- Reference official OCM documentation and related resources to support development and integration

### **📌 How to Use**

Configure the server using the following snippet:

```json

{

  "mcpServers": {

    "multicluster-mcp-server": {

      "command": "npx",

      "args": [

        "-y",

        "multicluster-mcp-server@latest"

      ]

    }

  }

}

```

**Note:** Ensure `kubectl` is installed. By default, the tool uses the **`KUBECONFIG`** environment variable to access the cluster. In a multi-cluster setup, it treats the configured cluster as the **hub cluster**, accessing others through it.

## License

This project is licensed under the [MIT License](LICENSE).