mcp-kubernetes

Model Context Protocol 用の Kubernetes サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code など）が、複数のコンテキストにわたって Kubernetes クラスターを検査・操作できるようにします。動作はすべてフラグで制御されます。

設計方針は デフォルトで安全 です。読み取り専用から始まり、名前空間とコンテキストの許可リストで範囲を制限できます。システム名前空間を変更から保護し、危険な操作（delete、apply、exec）は明示的な板オプトインをオンにしないと実行できないようになっています。

機能

• マルチクラスター — すべてのツールはオプションの context を受け付け、許可リストで使用可能なコンテキストの範囲を制限できます。

• アクセスモード — read-only → read-write → admin とレイヤー化。上位レベルのツールが下位のモードで公開されることはありません。

• セキュリティフラグ — 名前空間の許可リスト、保護名前空間、コンテキストの許可リストに加え、delete / apply / exec、dry-run、JSON 監査ログの各オプトイン（下記参照）。

• 標準認証 — 手元の kube-config（またはクラスタ内サービスアカウント）とさせていただきます。サーバー側で認証情報は保存せません。

Related MCP server: k8s-mcp-go

セキュリティモデル

これらはレイヤーとして独立しています。たとえば、admin モードなのに 3 つすべてのオプトインが false の場合、デプロイメントの再起動やスケーリングはできますが、リソースの削除も Pod への exec も行うことはできません。

ツール

読み取り（read-only以上）: list_contexts、list_namespaces、list_pods、get_pod、get_pod_logs、list_deployments、list_services、list_nodes、list_events、get_resource

書き込み（read-write以上）: scale_deployment、restart_deployment、set_deployment_image、create_namespace、apply_manifest（K8S_ALLOW_APPLY が必要）

管理（admin）: delete_resource（K8S_ALLOW_DELETE が必要）、exec_in_pod（K8S_ALLOW_EXEC が必要）

MCP クライアントでの使用

Claude Code、Claude Desktop、Cursor、OpenAI Codex CLI、Windsurf、VS Code（Copilot）、その他の MCP クライアントで動作します。クライアントごとの設定方法については docs/CLIENTS.md をご覧ください。

インストール

npm install
npm run build

Claude Desktop / Claude Code で実行する

MCP クライアントの設定に以下を追加します:

{
  "mcpServers": {
    "kubernetes": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-kubernetes/dist/index.js"],
      "env": {
        "KUBECONFIG_PATH": "/Users/you/.kube/config",
        "K8S_MODE": "read-only",
        "K8S_CONTEXT_ALLOWLIST": "staging",
        "K8S_NAMESPACE_ALLOWLIST": "app,web"
      }
    }
  }
}

スケーリングや再起動を行う場合は K8S_MODE を read-write に、削除や exec を許可する場合のみ admin（および関連する K8S_ALLOW_* フラグ）に変更して設定します。

開発

npm run dev        # watch mode
npm test           # unit tests for the security policy
npm run typecheck

公開

このサーバーは、公式 MCP レジストリ向けの server.json と、npm の所有権検証用の mcpName を同梱しています。npm への公開、MCP レジストリ・Smithery・Glama・Cursor・PulseMCP への掲載については PUBLISHING.md を参照してください。

ライセンス

MIT