mcpField
M
mcp-k8s-manager

mcp-k8s-manager

Local
github.com/crtdanieleCloud & Infra4Updated 72w ago
Repository

About mcp-k8s-manager

mcp-k8s-manager is an MCP server for managing Kubernetes clusters on AKS, aimed at users of conversational clients such as Claude Desktop. It exposes commands for switching Kubernetes contexts and running kubectl.

Key features

  1. 01Switch Kubernetes contexts with kubectx
  2. 02Run kubectl commands
  3. 03Use through Claude Desktop

Use cases

  1. 01Change the active AKS cluster context
  2. 02Run kubectl operations from a conversation

MCP support

The MCP server exposes tools to run kubectx and kubectl, allowing MCP clients to manage Kubernetes contexts and execute commands.

#mcp-k8s-manager#kubernetes#azure

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
  1. Crea e attiva un ambiente virtuale:
python -m venv venv
source venv/bin/activate
  1. Installa le dipendenze:
pip install -r requirements.txt
  1. (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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.