Kubernetesクラスターに接続して管理できるMCPサーバー。複数のソースから優先順にkubeconfigを読み込むこともサポートします。

https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed

設置と利用

前提条件

このMCPサーバーを他のツールで使用する前に、以下の条件を確認してください:

1. kubectlをインストールし、PATHにインストールしました
2. コンテキストが設定された有効なkubeconfigファイル
3. kubectl用に設定されたKubernetesクラスタ(例:minikube、Rancher Desktop、GKEなど)へのアクセス
4. Helm v3がPATHにインストールされ(ティラー不要)Helmを使う予定がない場合はオプションです。

ターミナルでkubectl get podsを実行すれば、認証情報の問題なくクラスターに接続できるか確認できます。

デフォルトでは、サーバーは~/.kube/configからkubeconfigを読み込みます。追加の認証オプション(環境変数、カスタムパスなど)についてはADVANCED_README.mdを参照してください。

クロード・コード

組み込みコマンドを使ってMCPサーバーをClaude Codeに追加します:

これにより、Claude CodeのMCP設定で自動的にサーバーが設定されます。

コデックス

組み込みコマンドを使ってMCPサーバーをCodex CLIに追加します:

MCP Server Kubernetes

MCP Server that can connect to a Kubernetes cluster and manage it. Supports loading kubeconfig from multiple sources in priority order.

https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed

Installation & Usage

Prerequisites

Before using this MCP server with any tool, make sure you have:

1. kubectl installed and in your PATH
2. A valid kubeconfig file with contexts configured
3. Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, GKE, etc.)
4. Helm v3 installed and in your PATH (no Tiller required). Optional if you don’t plan to use Helm.

You can verify your connection by running kubectl get pods in a terminal to ensure you can connect to your cluster without credential issues.

By default, the server loads kubeconfig from ~/.kube/config. For additional authentication options (environment variables, custom paths, etc.), see ADVANCED_README.md.

Claude Code

Add the MCP server to Claude Code using the built-in command:

claude mcp add kubernetes -- npx mcp-server-kubernetes

This will automatically configure the server in your Claude Code MCP settings.

Codex

Add the MCP server to Codex CLI using the built-in command:

codex mcp add kubernetes -- npx mcp-server-kubernetes

This registers the server globally in ~/.codex/config.toml and makes its tools available in all Codex sessions.

Claude Desktop

Add the following configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }