Kubeview MCP

🚀 KubeView MCP – Kubernetesモデルコンテキストプロトコルサーバ

KubeView は読み取り専用のモデルコンテキストプロトコル（MCP）サーバで、AIエージェント（Cursor IDE、Claude Code CLI、Codex CLI、Gemini CLIなど）がKubernetesクラスタを安全に調査、診断、デバッグできるようにします。Kubernetes、Helm、Argo Workflows、Argo CDに対する包括的なツールセットを提供します。 Evicting MCP tool calls from your Kubernetes cluster でコードモードの利点と実装について詳しく学ぶことができます。

✨ 主な機能

• 🧠 コードモード：複雑な推論と多段階のワークフローのためのサンドボックス化されたTypeScript環境。
• 🛡️ 読み取り専用で安全：書き込みアクセスをゼロにし、機密データをマスキングすることで、本番環境での安全性を考慮して設計されています。
• ☸️ Kubernetes統合：リソースの一覧表示/取得、メトリクスの取得、ログとイベントのストリーミング、コマンドの実行、およびネットワーク問題の診断ツール。
• 📦 Helmサポート：リリース、値、マニフェスト、および履歴の調査。
• 🐙 Argoエコシステム：直接的なKubernetes APIまたはCLIを使用してArgo WorkflowsとArgo CDアプリケーションを管理。

🚀 クイックスタート

前提条件

• Node.js ≥ 18
• Kubernetesクラスタへのアクセス
• オプションで、現在の $PATH にインストールされたCLI：helm、argo、argocd

インストール

# サーバを起動
npx -y kubeview-mcp

# claude code mcpサーバとしてインストール
claude mcp add kubernetes -- npx kubeview-mcp

MCPクライアントの設定

mcpServers 設定（例：CursorまたはClaude Desktop）に追加します。

{
  "mcpServers": {
    "kubeview": {
      "command": "npx",
      "args": ["-y", "kubeview-mcp"]
    }
  }
}

環境変数

環境変数を使用してサーバを構成します。

🛠️ ツールの概要

Kubernetes

• kube_list：リソースを一覧表示またはクラスタの診断情報を取得。
• kube_get：特定のリソースを説明（すべてのK8sタイプをサポート）。
• kube_metrics：ノードとポッドのCPU/メモリメトリクスを取得。
• kube_logs：コンテナのログを取得またはストリーミング。
• kube_exec：コンテナ内でコマンドを実行（読み取り専用が推奨）。
• kube_port：ポッド/サービスへのポート転送。
• kube_net：クラスタ内のネットワーク診断を実行。

Helm

• helm_list：Helmリリースを一覧表示。
• helm_get：リリースの値、マニフェスト、および履歴を取得。

Argo

• argo_list / argo_get：Argo Workflowsを管理。
• argocd_app：Argo CDアプリケーションとリソースを調査。

ユーティリティ

• run_code：複雑なタスクのためにサンドボックス化されたTypeScriptコードを実行。

🧠 コードモード

Code execution with MCP から着想を得たKubeViewは、エージェントがAPIを探索し、ツールを検索し、サンドボックス環境で複雑なワークフローを実行できるコードモードランタイムを備えています。

提供する機能

• MCPブリッジレイヤー：すべての登録されたMCPサーバツールにシームレスに接続。
• 動的なTypeScript定義：ツールのスキーマを自動的に強力な型付きの global.d.ts リソースに変換し、エージェントが有効なTypeScriptパターンを使用し、パラメータを誤って生成することなく型安全性を享受できるようにします。
• ツール検索ユーティリティ：tools.search() や tools.list() などのランタイムヘルパーにより、エージェントが最初から全体のスキーマコンテキストを読み込む必要なく、段階的に機能を発見できます。
• サンドボックス化された実行：console と tools グローバルオブジェクトへのアクセスが制御されたロックダウンされたNode.js環境（vm を介して）で、エージェントが生成したコードを安全に実行します。

使用方法

ロジック、ループ、またはデータ処理を必要とする複雑なタスクには、コードモード を使用します。

"env": { "MCP_MODE": "code" }

💡 コードモードのプロヒント

サーバには、完全なTypeScript APIドキュメント、ツールの概要、および例をコンテキストに注入する組み込みのプロンプト code-mode が含まれています。

Cursor IDEで： プロンプトに /kubeview/code-mode と入力するだけ（または / プロンプトメニューから選択）で、AIに正しい run_code スクリプトをすぐに書くために必要な正確なコンテキストを与えます。

💻 ローカル開発

1. クローンとインストール：

   git clone https://github.com/mikhae1/kubeview-mcp.git
   cd kubeview-mcp
   npm install
   

2. ビルドと実行：

   npm run build
   npm start
   

3. テスト：

   npm test
   

CLIの使用方法

CLIを介して直接ツールをテストできます。

npm run command -- kube_list --namespace=default

📄 ライセンス

MIT © mikhae1