mcp-k8s-manager

mcp-k8s-manager

Claude Desktopから利用できる、AKS（Azure Kubernetes Service）上のKubernetesクラスターを管理するMCP サーバーです。会話型インターフェースから直接、kubectlとkubectxコマンドを実行するツールを提供します。

---

要件

以下がインストールされていることを確認してください。

• Python ≥ 3.10
• kubectl
• kubectx
• Azure CLI
• Claude Desktop

---

ローカルインストール

1. リポジトリをクローンします。

git clone https://github.com/crtdaniele/mcp-k8s-manager
cd mcp-k8s-manager

2. 仮想環境を作成して有効にします。

python -m venv venv
source venv/bin/activate

3. 依存関係をインストールします。

pip install -r requirements.txt

4. （任意）新しいライブラリを追加した後、requirements.txtを更新します。

pip freeze > requirements.txt

MCP サーバーの起動

ホットリロードを有効にして開発モードでMCP サーバーを実行するには、次のコマンドを実行します。

mcp dev main.py

通常モードでサーバーを実行するには、次のコマンドを実行します。

mcp run main.py

ツール

利用可能なツール：

• run_kubectx：

kubectxを使用してKubernetesのコンテキストを切り替えます。

• run_kubectl：

kubectlコマンドを実行します。先にkubectxを使ってコンテキストを切り替えることもできます。

Claude Desktopへのインストール

mcp install main.py

または、settings.jsonファイルを手動で設定します（Claude Desktop > Settings > Advanced）。

{
  "mcpServers": {
    "mcp-k8s-manager": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "your-local-path/main.py"
      ]
    }
  }
}

ライセンス

MIT License。 © 2025 Daniele Carta

コントリビュート

プルリクエストを歓迎します！

issueを作成して、バグを報告したり機能をリクエストしたりしてください。