Kubernetes Monitoring

🚀 k8s-mcp

このプロジェクトは、Python ベースの読み取り専用の Kubernetes クラスタ モデルコンテキストプロトコル (MCP) サーバーです。クラスタ情報の取得や問題の診断を行うための包括的な API を提供します。

Claude を使用したサンプルチャット

🚀 クイックスタート

このセクションでは、k8s - mcp サーバーのクイックスタートについて説明します。以下の手順に従って、サーバーをセットアップして使用できます。

✨ 主な機能

• Python ベースの読み取り専用の Kubernetes クラスタ MCP サーバーを提供します。
• クラスタ情報の取得や問題の診断を行うための包括的な API を備えています。

📦 インストール

前提条件

• Python 3.8 以上
• Kubernetes クラスタへのアクセス権限（kubeconfig または in - cluster 設定を通じて）
• 必要な Python パッケージ（pyproject.toml の dependencies を参照）

# uv のインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# リポジトリのクローン
git clone git@github.com:vlttnv/k8s-mcp.git
cd k8s-mcp

# 依存関係のインストール
uv venv
source .venv/bin/activate
uv sync

Claude を使用する場合は、デスクトップアプリの設定を構成してください。以下のコマンドで設定ファイルをテキストエディタで開きます。

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "k8s-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/k8s-mcp",
                "run",
                "server.py"
            ]
        }
    }
}

⚠️ 重要提示

必要に応じて、command フィールドに uv 実行ファイルの完全パスを指定する必要がある場合があります。macOS/Linux では which uv、Windows では where uv を実行して取得できます。

📚 ドキュメント

設定

アプリケーションは自動的に 2 つの方法で Kubernetes クラスタに接続を試みます。

1. Kubeconfig ファイル：ローカルの kubeconfig ファイル（通常は ~/.kube/config）を使用します。
2. In - Cluster Configuration：Kubernetes pod 内で実行されている場合、サービスアカウントトークンを使用します。

kubeconfig が正しく設定されているか、またはクラスタ内で適切な RBAC 権限を持っている場合は、追加の設定は必要ありません。

使用方法

インストール手順

1. リポジトリをクローンし、ディレクトリに移動します。
2. uv ツールを使用して仮想環境を作成し、アクティブ化します。
3. 依存関係を同期した後、サービスを起動します。

サンプルクエリ

# 基本コマンドの例
uv run server.py

📄 ライセンス

MIT License

貢献

皆さんの貢献を歓迎します！Pull Request をいつでも送信してください。