What is Mcp K8s Manager

mcp-k8s-manager is an MCP server designed for managing Kubernetes clusters on Azure Kubernetes Service (AKS), which can be utilized from Claude Desktop. It provides tools to execute kubectl and kubectx commands directly from a conversational interface.

Use cases

Use cases include managing multiple Kubernetes clusters, switching contexts seamlessly, executing commands for deployment and scaling applications, and facilitating easier management of cloud-native applications.

How to use

To use mcp-k8s-manager, clone the repository, set up a virtual environment, install the dependencies, and run the server either in development mode with hot reload or in normal mode. It can also be installed directly on Claude Desktop.

Key features

Key features include the ability to change Kubernetes contexts using kubectx and execute kubectl commands, all from a conversational interface, enhancing user interaction and management efficiency.

Where to use

mcp-k8s-manager is primarily used in cloud computing environments, particularly for managing Kubernetes clusters on Azure, making it suitable for DevOps teams and cloud engineers.

mcp-k8s-manager

Un MCP server per la gestione di cluster Kubernetes su AKS (Azure Kubernetes Service), utilizzabile da Claude Desktop. Offre strumenti per eseguire comandi kubectl e kubectx direttamente da un’interfaccia conversazionale.

Requisiti

Assicurati di avere installato:

• Python ≥ 3.10
• kubectl
• kubectx
• Azure CLI
• Claude Desktop

Installazione locale

1. Clona il repository:

git clone https://github.com/crtdaniele/mcp-k8s-manager
cd mcp-k8s-manager

2. Crea e attiva un ambiente virtuale:

python -m venv venv
source venv/bin/activate

3. Installa le dipendenze:

pip install -r requirements.txt

4. (Facoltativo) Aggiorna il file requirements.txt dopo aver aggiunto nuove librerie:

pip freeze > requirements.txt

Avvio del server MCP

Per eseguire il server MCP in modalità sviluppo con hot reload:

mcp dev main.py

Per eseguire il server in modalità normale:

mcp run main.py

Tool

Tool disponibili:

• run_kubectx:

Cambia contesto Kubernetes usando kubectx.

• run_kubectl:

Esegue comandi kubectl. È possibile cambiare contesto prima con kubectx.

Installazione su Claude Desktop

mcp install main.py

Oppure configura manualmente il file settings.json (Claude Desktop > Settings > Advanced):

{
  "mcpServers": {
    "mcp-k8s-manager": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "your-local-path/main.py"
      ]
    }
  }
}

Licenza

MIT License.
© 2025 Daniele Carta

Contribuire

Pull request benvenute!

Segnala bug o richiedi funzionalità aprendo una issue.