Mcp K8s Eye

mcp-k8s-eye

mcp-k8s-eye は、Kubernetes クラスターを管理し、ワークロードの状態を分析するツールです。

機能

Kubernetes の基本操作

• Kubernetes クラスターに接続
• 汎用 Kubernetes リソースの管理機能
  • すべてのネイティブリソースに対応：Pod、Deployment、Service、StatefulSet、Ingress...
  • CustomResourceDefinition リソースに対応
  • 次の操作に対応：一覧表示、取得、作成、更新、削除
• Pod の管理機能（exec、ログ）
• Deployment の管理機能（スケール）
• Kubernetes リソースの詳細表示
• Kubernetes リソースの説明

診断

• Pod の診断（Pod の状態、コンテナの状態、Pod のリソース使用率を分析）
• Service の診断（Service のセレクター設定、準備できていないエンドポイント、イベントを分析）
• Deployment の診断（利用可能なレプリカ数を分析）
• StatefulSet の診断（存在する場合は StatefulSet の Service と PVC、利用可能なレプリカ数を分析）
• CronJob の診断（CronJob のスケジュール、開始期限、最終スケジュール時刻を分析）
• Ingress の診断（Ingress クラスの設定、関連する Service、TLS シークレットを分析）
• NetworkPolicy の診断（NetworkPolicy の設定、影響を受ける Pod を分析）
• ValidatingWebhook の診断（Webhook の設定、参照される Service と Pod を分析）
• MutatingWebhook の診断（Webhook の設定、参照される Service と Pod を分析）
• Node の診断（Node の状態を分析）
• クラスターの診断とトラブルシューティング

モニタリング

• Pod、Deployment、ReplicaSet、StatefulSet、DaemonSet のワークロードリソース使用量（CPU、メモリ）
• Node の容量、使用率（CPU、メモリ）
• クラスターの容量、使用率（CPU、メモリ）

高度な機能

• 複数のトランスポートプロトコルに対応（Stdio、SSE）
• 複数の AI クライアントに対応

ツールの使用方法

リソース操作ツール

• resource_get：名前空間内の特定のリソースの詳細情報を取得
• resource_list：名前空間内のすべてのリソースの詳細情報を一覧表示
• resource_create_or_update：名前空間内のリソースを作成または更新
• resource_delete：名前空間内のリソースを削除
• resource_describe：名前空間内のリソースの詳細情報を表示
• deployment_scale：名前空間内の Deployment をスケール
• pod_exec：名前空間内の Pod でコマンドを実行`
• pod_logs：名前空間内の Pod のログを取得

診断ツール

• pod_analyze：名前空間内のすべての Pod を診断
• deployment_analyze：名前空間内のすべての Deployment を診断
• statefulset_analyze：名前空間内のすべての StatefulSet を診断
• service_analyze：名前空間内のすべての Service を診断
• cronjob_analyze：名前空間内のすべての CronJob を診断
• ingress_analyze：名前空間内のすべての Ingress を診断
• networkpolicy_analyze：名前空間内のすべての NetworkPolicy を診断
• validatingwebhook_analyze：すべての ValidatingWebhook を診断
• mutatingwebhook_analyze：すべての MutatingWebhook を診断
• node_analyze：クラスター内のすべての Node を診断

モニタリングツール

• workload_resource_usage：名前空間内の Pod／Deployment／ReplicaSet／StatefulSet のリソース使用量を取得（CPU、メモリ）

要件

• Go 1.23 以降
• kubectl の設定

インストール

# clone the repository
git clone https://github.com/wenhuwang/mcp-k8s-eye.git
cd mcp-k8s-eye

# build the binary
go build -o mcp-k8s-eye

使用方法

Stdio モード

{
  "mcpServers": {
    "k8s eye": {
      "command": "YOUR mcp-k8s-eye PATH",
      "env": {
        "HOME": "USER HOME DIR"
      },
    }
  }
}

env.HOME は、kubeconfig ファイルの HOME ディレクトリを設定するために使用されます。

SSE モード

1. MCP SSE サーバーを起動します
2. MCP サーバーを設定します

{
  "mcpServers": {
    "k8s eye": {
      "url": "http://localhost:8080/sse",
      "env": {}
    }
  }
}

cursor tools