Kubernetes MCP Server

Kubernetes MCP Server

自然言語を使用して Kubernetes の設定をデバッグ、管理する MCP サーバーです。

この MCP サーバーでは、次のことができます。

1. Kubernetes の設定 YAML/YML ファイルをデバッグする
2. YAML/YML ファイルを含む Kubernetes 設定フォルダー全体をデバッグする
3. Kubernetes クラスターに接続して管理する

機能

• Kubernetes の設定 YAML/YML ファイルをデバッグ、分析する
• YAML/YML ファイルを含む Kubernetes 設定フォルダー全体をデバッグする
• Pod の管理（一覧表示、取得、ログの確認、削除）
• Deployment の管理（作成、一覧表示、取得、ログの確認、削除）
• Service の管理（作成、一覧表示、取得、ログの確認、削除）
• Namespace の管理（一覧表示、取得、ログの確認、削除）
• ログ、Service、Seployment、Statefulset、Demonsets、Ingress、Node、Cluster のデバッグと分析
• Pod または Service へのポートフォワード
• Helm Chart のインストールと管理

クイックスタート

1. Claude Desktop をインストールします

2. この MCP サーバーをインストールします

• uv を使用する場合：uv

実行：uv pip install git+https://github.com/ehiaig/kubernetes-mcp-server

または

• このリポジトリをクローンします： git clone https://github.com/ehiaig/kubernetes-mcp-server.git

3. Claude の JSON ファイルを開きます

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

次に、MCP サーバーのファイルに以下を追加します。

Claude Desktop でのローカルテスト用

{
    "kubernetes-mcp-server": {
    "command": "/path/to/your/.local/bin/uv", // or "uv"
    "args": [
        "--directory",
        "/path/to/this/repo/kubernetes-mcp-server/src/k8s_manager",
        "run",
        "-m",
        "k8s_manager"
    ]
  }
}

claude_desktop_config.json ファイルは、次のようになります。

{
    "mcpServers": {
        "kubernetes-mcp-server": {
            "command": "/path/to/your/.local/bin/uv",
            "args": [
                "--directory",
                "/path/to/this/repo/kubernetes-mcp-server/src/k8s_manager",
                "run",
                "-m",
                "k8s_manager"
            ]
        }
    }
}

公開済みサーバーの場合

"mcpServers": {
  "kubernetes-mcp-server": {
    "command": "uvx",
    "args": [
      "k8s_manager"
    ]
  }
}

🚧免責事項

機密データ

機密データを含むクラスターを設定しないでください。これにはシークレット、パスワードなどが含まれます。

LLM とやり取りする機密データは、LLM が完全にローカルマシン上で実行されていない限り、本質的に漏えいしたものと見なされます。

シークレットを安全にクラスターへ渡す方法に関心がある場合は、ユースケースを添えてこのリポジトリに Issue を作成してください。