Kubernetes'e bağlanan Golang tabanlı MCP sunucusu

MCP K8S Go

Özellikler ⚙ Inspector ile Göz Atın ⚙ Claude ile Kullanın ⚙ Katkıda Bulunun ↗ ⚙ MCP Hakkında ↗

Özellikler

MCP 💬 prompt 🗂️ resource 🤖 tool

• 🗂️🤖 Kubernetes context'lerini listeleyin
• 💬🤖 Kubernetes namespace'lerini listeleyin
• 🤖 Herhangi bir Kubernetes kaynağını listeleyin, alın, oluşturun ve değiştirin
  • pod, service, deployment gibi kaynaklar için özel mappingler içerir
• 🤖 Kubernetes node'larını listeleyin
• 💬 Kubernetes pod'larını listeleyin
• 🤖 Kubernetes event'lerini alın
• 🤖 Kubernetes pod log'larını alın
• 🤖 Kubernetes pod'unda komut çalıştırın

Inspector ile Göz Atın

En son yayınlanan versiyonu Inspector ile kullanmak için şu komutu çalıştırabilirsiniz:

npx @modelcontextprotocol/inspector npx @strowk/mcp-k8s

Claude ile Kullanın

Demo Kullanımı

Aşağıdaki Claude Desktop sohbeti, belirli bir context'i resource olarak seçtikten sonra kube-system namespace'inde pod log'larında hataları kontrol etmesi istenen örneği göstermektedir:

Bu MCP sunucusunu Claude Desktop (veya başka herhangi bir client) ile kullanmak için hangi kurulum yöntemini seçeceğinize karar vermeniz gerekebilir.

Birden fazla seçeneğiniz vardır:

	Smithery	mcp-get	Önceden derlenmiş NPM	Github'da Önceden derlenmiş	Kaynak kodundan	Docker Kullanarak
Claude Kurulumu	Otomatik	Otomatik	Manuel	Manuel	Manuel	Manuel
Ön Koşul	Node.js	Node.js	Node.js	Hiçbiri	Golang	Docker

Smithery Kullanarak

MCP K8S Go'yu Claude Desktop'a Smithery aracılığıyla otomatik olarak kurmak için:

npx -y @smithery/cli install @strowk/mcp-k8s --client claude

mcp-get Kullanarak

MCP K8S Go'yu Claude Desktop'a mcp-get aracılığıyla otomatik olarak kurmak için:

npx @michaellatman/mcp-get@latest install @strowk/mcp-k8s

Önceden derlenmiş ikili dosyalarla Manuel Kurulum

NPM'den Önceden Derlenmiş

npm yüklüyse ve önceden derlenmiş ikili dosyaları kullanmak istiyorsanız bunu kullanın:

npm install -g @strowk/mcp-k8s

Ardından mcp-k8s --version komutunu çalıştırarak versiyonu kontrol edin ve bu yüklü versiyonu yazdırırsa, claude_desktop_config.json dosyasına konfigürasyon eklemeye devam edebilirsiniz:

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s",
      "args": []
    }
  }
}

, veya herhangi bir client ile npx kullanarak:

npx @strowk/mcp-k8s

Örneğin Claude için:

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "npx",
      "args": [
        "@strowk/mcp-k8s"
      ]
    }
  }
}

GitHub Releases'tan

GitHub releases sayfasına gidin ve platformunuz için en son release'i indirin.

Arşivi açın, içinde mcp-k8s-go adlı ikili dosya olacaktır, bu dosyayı PATH'inize bir yere koyun ve ardından claude_desktop_config.json dosyasına aşağıdaki konfigürasyonu ekleyin:

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

Kaynak Kodundan Derleme

Bu projeyi derlemek için Golang yüklü olması gerekir:

go get github.com/strowk/mcp-k8s-go
go install github.com/strowk/mcp-k8s-go

, ardından claude_desktop_config.json dosyasına aşağıdaki konfigürasyonu ekleyin:

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

Docker Kullanarak

Bu sunucu 0.3.1-beta.2 release'inden itibaren Docker Hub'da derlenmiş ve yayınlanmakta, linux/amd64 ve linux/arm64 mimarileri için çok mimarili imajlar mevcuttur.

En son tag'ı örneğin şöyle kullanabilirsiniz:

docker run -i -v ~/.kube/config:/home/nonroot/.kube/config --rm mcpk8s/server:latest

Windows kullanıcıları en azından Git Bash'te ~/.kube/config yerine //c/Users/<username>/.kube/config ile değiştirmek gerekebilir.

Claude için:

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-v",
        "~/.kube/config:/home/nonroot/.kube/config",
        "--rm",
        "mcpk8s/server:latest"
      ]
    }
  }
}

Ortam Değişkenleri ve Komut Satırı Seçenekleri

MCP sunucusu tarafından kullanılan ortam değişkenleri:

• KUBECONFIG: Kubernetes yapılandırma dosyanızın yolu (isteğe bağlı, varsayılan olarak ~/.kube/config)

Desteklenen komut satırı seçenekleri:

• --allowed-contexts=<ctx1,ctx2,...>: Kullanıcıların erişebileceği Kubernetes context'lerinin virgülle ayrılmış listesi. Belirtilmezse, tüm context'lere izin verilir.
• --readonly: Cluster'a değişiklik yazabilen tüm tool'ları devre dışı bırakır
• --help: Yardım bilgisini görüntüle
• --version: Sürüm bilgisini görüntüle
• --mask-secrets: Çıktıda secret'ları maskelyin (varsayılan: true). Maskelemeyi devre dışı bırakmak için --mask-secrets=false kullanın

Örneğin Claude Desktop'u yapılandırıyorsanız, claude_desktop_config.json dosyasına aşağıdaki konfigürasyonu ekleyebilirsiniz:

{
    "mcpServers": {
        "mcp_k8s": {
            "command": "mcp-k8s",
            "args": [
                "--allowed-contexts=dev,prod",
                "--readonly"
            ]
        }
    }
}

, bu yalnızca dev ve prod context'lerinin kullanılmasına izin verir ve cluster'a değişiklik yazabilen tüm tool'ları devre dışı bırakır.