Kubernetes MCP Server 🚀

Kubernetes MCP サーバー 🚀

Kubernetes MCP サーバーは、Kubernetes API とシームレスに連携する Model Context Protocol (MCP) サーバーです。開発者、運用担当者、AI ツール向けに、高度な自動化と操作機能を提供します。

目次

• Kubernetes MCP サーバー 🚀
  • 目次
  • 概要 📊
  • 前提条件 ✅
  • インストール 💻
    • Claude Desktop での使用
    • VS Code での使用
    • Cline での使用
    • ソースからビルドする
  • コマンドラインオプション ⌨️
  • サーバートランスポートのオプション 🔄
    • stdio
    • SSE
  • アクセス制御 🔒
  • ツール 🧰
    • リソース操作 📦
    • 管理操作 ⚙️
  • 今後の機能強化 🔮
  • コントリビューション 👥
  • ライセンス ⚖️

概要 📊

この MCP サーバーを使用すると、AI ツールが自然言語で Kubernetes クラスターを操作し、次の機能を利用できます。

• 🔍 クラスターのリソースを取得して分析する
• 📈 デプロイメント、ポッド、サービスを監視する
• 🛠️ AI インターフェースを通じて一般的な kubectl 操作を実行する
• 🔧 AI アシスタンスを利用してクラスターの問題をトラブルシューティングする

前提条件 ✅

1. API にアクセスできる Kubernetes クラスター
2. 有効な kubeconfig ファイルまたはサービスアカウントの認証情報
3. 必要な操作に対する適切な RBAC 権限

インストール 💻

Claude Desktop での使用

以下を Claude Desktop の設定ファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "kubernetes": {
      "command": "path/to/k8smcp",
      "args": [
        "stdio",
        "--kubeconfig=/path/to/your/kubeconfig"
      ]
    }
  }
}

VS Code での使用

以下を VS Code のユーザー設定（JSON）ファイル、またはワークスペース内の .vscode/mcp.json に追加します。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kubeconfig_path",
        "description": "Path to kubeconfig file",
        "default": "${env:HOME}/.kube/config"
      }
    ],
    "servers": {
      "kubernetes": {
        "command": "path/to/k8smcp",
        "args": [
          "stdio",
          "--kubeconfig=/path/to/your/kubeconfig"
        ]
      }
    }
  }
}

Cline での使用

Cline の設定ファイル（「Configure MCP Servers」を選択した後の path/to/cline_mcp_settings.json）に以下を追加します。

{
  "mcpServers": {
    "kubernetes": {
      "disabled": false,
      "timeout": 60,
      "command": "path/to/k8smcp",
      "args": [
        "stdio",
        "--read-only=false"
        "--kubeconfig=/path/to/your/kubeconfig"
      ],
      "env": {
        "K8S_MCP_TOOLSETS": "all"
      },
      "transportType": "stdio"
    }
  }
}

command の値を k8smcp 実行ファイルへのパスに更新してください。サーバーの設定には args または env を使用できます。

ソースからビルドする

リポジトリをクローンして、バイナリをビルドします。

git clone https://github.com/briankscheong/k8s-mcp-server.git
cd k8s-mcp-server
make build

または、Go を使って直接インストールします。

go install github.com/briankscheong/k8s-mcp-server/cmd/k8s-mcp-server@latest

コマンドラインオプション ⌨️

A Kubernetes MCP Server that provides tools for interacting with Kubernetes clusters.

Environment Variables:
  K8S_MCP_KUBECONFIG            Path to kubeconfig file
  K8S_MCP_NAMESPACE             Default Kubernetes namespace
  K8S_MCP_IN_CLUSTER            Use in-cluster config (true/false)
  K8S_MCP_READ_ONLY             Restrict to read-only operations (true/false)
  K8S_MCP_RESOURCE_TYPES        Comma-separated list of resource types
  K8S_MCP_TOOLSETS              Comma-separated list of toolsets to enable
  K8S_MCP_EXPORT_TRANSLATIONS   Export translations (true/false)

Usage:
  k8smcp [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  sse         Start sse server
  stdio       Start stdio server

Flags:
      --export-translations      Save translations to a JSON file
  -h, --help                     help for k8smcp
      --in-cluster               Use in-cluster config instead of kubeconfig file
      --kubeconfig string        Path to the kubeconfig file (default "/Users/briancheong/.kube/config")
      --namespace string         Default Kubernetes namespace to target (default "default")
      --read-only                Restrict operations to read-only (no create, update, delete) (default true)
      --resource-types strings   Comma separated list of Kubernetes resource types to enable (pods,deployments,services,configmaps,namespaces,nodes) (default [all])
      --toolsets strings         Comma separated list of tools to enable (default [all])
  -v, --version                  version for k8smcp

Use "k8smcp [command] --help" for more information about a command.

サーバートランスポートのオプション 🔄

stdio

stdio トランスポートはデフォルトであり、ローカル連携ではほとんどのユーザーに推奨されるオプションです。

k8smcp stdio --kubeconfig=/path/to/your/kubeconfig

SSE

sse トランスポートは、HTTP ベースの JSON-RPC メッセージトランスポートをサポートします。クライアント接続用のポートを公開する必要がある Kubernetes クラスターにサーバーをデプロイする場合に便利です。

k8smcp sse --in-cluster=true

メモ

サーバーを Kubernetes クラスターにデプロイする場合は、--in-cluster=true フラグを設定する必要があります。

アクセス制御 🔒

デフォルトでは、サーバーは指定された kubeconfig またはサービスアカウントの権限を適用します。セキュリティを強化するには、次のことができます。

1. RBAC 権限を制限した専用のサービスアカウントを作成する
2. 名前空間をまたぐ操作を防ぐため、名前空間の制限を設定する
3. クラスターの状態が変更されないよう、読み取り専用モードを有効にする

ツール 🧰

Kubernetes MCP サーバーは、Kubernetes クラスターを操作するための包括的なツールセットを提供します。

リソース操作 📦

• get_pod - 特定のポッドの詳細情報を取得します

  • namespace：ポッドの名前空間（文字列、任意。デフォルトは現在の名前空間）
  • name：ポッド名（文字列、必須）

• list_pods - 名前空間内のポッドを一覧表示します

  • namespace：ポッドを一覧表示する名前空間（文字列、任意。デフォルトは現在の名前空間）
  • label_selector：ラベルセレクターでポッドを絞り込みます（文字列、任意）
  • field_selector：フィールドセレクターでポッドを絞り込みます（文字列、任意）

• get_pod_logs - ポッドのログを取得します

  • namespace：ポッドの名前空間（文字列、任意。デフォルトは現在の名前空間）
  • name：ポッド名（文字列、必須）
  • container：コンテナー名（文字列、任意。デフォルトは最初のコンテナー）
  • tail_lines：末尾から取得する行数（数値、任意）
  • previous：前のコンテナーインスタンスのログを取得します（ブール値、任意）

• get_deployment - 特定のデプロイメントの情報を取得します

  • namespace：デプロイメントの名前空間（文字列、任意。デフォルトは現在の名前空間）
  • name：デプロイメント名（文字列、必須）

• list_deployments - 名前空間内のデプロイメントを一覧表示します

  • namespace：デプロイメントを一覧表示する名前空間（文字列、任意。デフォルトは現在の名前空間）
  • label_selector：ラベルセレクターでデプロイメントを絞り込みます（文字列、任意）

• get_service - 特定のサービスの情報を取得します

  • namespace：サービスの名前空間（文字列、任意。デフォルトは現在の名前空間）
  • name：サービス名（文字列、必須）

• list_services - 名前空間内のサービスを一覧表示します

  • namespace：サービスを一覧表示する名前空間（文字列、任意。デフォルトは現在の名前空間）
  • label_selector：ラベルセレクターでサービスを絞り込みます（文字列、任意）

• get_configmap - 特定の ConfigMap の情報を取得します

  • namespace：ConfigMap の名前空間（文字列、任意。デフォルトは現在の名前空間）
  • name：ConfigMap 名（文字列、必須）

• list_configmaps - 名前空間内の ConfigMap を一覧表示します

  • namespace：ConfigMap を一覧表示する名前空間（文字列、任意。デフォルトは現在の名前空間）
  • label_selector：ラベルセレクターで ConfigMap を絞り込みます（文字列、任意）

• list_namespaces - クラスター内のすべての名前空間を一覧表示します

  • 必要なパラメーターはありません

• list_nodes - クラスター内のすべてのノードを一覧表示します

  • 必要なパラメーターはありません

管理操作 ⚙️

• delete_pod - 名前空間からポッドを削除します

  • namespace：ポッドの名前空間（文字列、任意。デフォルトは現在の名前空間）
  • name：ポッド名（文字列、必須）
  • grace_period_seconds：削除までの猶予期間（数値、任意）

• scale_deployment - デプロイメントのレプリカ数を指定した数にスケーリングします

  • namespace：デプロイメントの名前空間（文字列、任意。デフォルトは現在の名前空間）
  • name：デプロイメント名（文字列、必須）
  • replicas：レプリカ数（数値、必須）

重要

デフォルトでは、クラスター内のリソースを変更するツールは無効になっています。有効にするには、--read-only=false フラグまたは K8S_MCP_READ_ONLY=false 環境変数を設定する必要があります。

今後の機能強化 🔮

• よりきめ細かなアクセス制御を実現する、RBAC との連携強化
• より多くの Kubernetes リソースへの対応
• カスタムリソース定義（CRD）への対応
• デプロイメント向けの Helm チャート管理機能
• クラスターの監視およびアラート機能との連携
• 複数のクラスター接続の同時利用への対応

コントリビューション 👥

コントリビューションを歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス ⚖️

このプロジェクトは MIT License のもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

---