MCP K8s Eye

🚀 mcp-k8s-eye

mcp-k8s-eye は、Kubernetes クラスタを管理し、ワークロードの状態を分析することができるツールです。このツールにより、Kubernetes クラスタの操作や診断、監視などを効率的に行うことが可能です。

✨ 主な機能

コア Kubernetes 操作

• [x] Kubernetes クラスタへの接続
• [x] 汎用 Kubernetes リソース 管理機能
  • すべての組み込みリソース（Pod、Deployment、Service、StatefulSet、Ingress など）をサポート
  • カスタムリソース定義（CustomResourceDefinition）をサポート
  • 操作には、一覧表示、取得、作成、更新、削除が含まれます
• [x] Pod 管理機能（コマンドの実行、ログの表示）
• [x] Deployment 管理機能（スケーリング）

診断

• [x] Pod 診断（Pod とコンテナの状態の分析）
• [x] Service 診断（サービスセレクタの設定、未就緒のエンドポイント、イベントの分析）
• [x] Deployment 診断（利用可能なレプリカ数の分析）
• [x] StatefulSet 診断（ステートフルセットサービスの存在、PVC の存在、利用可能なレプリカ数の分析）
• [x] CronJob 診断（タイマータスクのスケジュール、開始期限、前回の実行時間の分析）
• [x] Ingress 診断（ingress クラスの設定、関連するサービス、TLS 証明書の分析）
• [x] NetworkPolicy 診断（ネットワークポリシーの設定、影響を受ける Pod の分析）
• [x] ValidatingWebhook 診断（Webhook の設定、参照されるサービスと Pod の分析）
• [x] MutatingWebhook 診断（Webhook の設定、参照されるサービスと Pod の分析）
• [x] Node 診断（ノードの条件の分析）
• [ ] クラスタ診断とトラブルシューティング

監視

• [ ] Pod の使用状況、利用率（CPU、メモリ）
• [ ] Deployment と Namespace レベルのリソース使用状況（CPU、メモリ）
• [ ] Node の容量、利用率（CPU、メモリ）
• [ ] クラスタの容量、利用率（CPU、メモリ）

高度な機能

• [x] 複数の転送プロトコルのサポート（標準入出力、ストリーミングデータ）
• [x] 複数の AI クライアントのサポート

📦 インストール

必要条件

• Go 1.23 以上のバージョン
• kubectl が設定されていること

インストール手順

# リポジトリをクローンする
git clone https://github.com/wenhuwang/mcp-k8s-eye.git
cd mcp-k8s-eye

# バイナリファイルをビルドする
go build -o mcp-k8s-eye

💻 使用例

基本的な使用法

標準入出力モード

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

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

ストリーミングデータモード

1. mcp ストリーミングサーバを起動します。
2. mcp サーバを設定します。

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

カーソルツール