Flux159/mcp-server-kubernetes

MCP Server Kubernetes – AI対応のKubernetes制御

何であるか – Model Context Protocol (MCP) を扱う小さなNodeスタイルのサーバー（npx mcp-server-kubernetesで実行）です。AI対応のアシスタント（Claude、Codex、VS Code拡張機能、Cursorなど）が、ローカルのKubernetesクラスタに対して kubectl 風のコマンド、Helm操作、ポートフォワード、ノードメンテナンス、診断を実行できるようにします。

なぜ重要か – Kubernetes操作を標準的なMCPインターフェースで公開することで、開発者はCLIコードを一切書かずにLLMに ポッドの一覧表示、マニフェストの適用、デプロイメントのスケーリング、または 失敗したポッドのトラブルシューティング を依頼できます。サーバーは安全のため読み取り専用モードで実行でき、オプションでOpenTelemetryトレースを出力して観測性を確保できます。

クイックスタート

前提条件 – kubectl、有効な ~/.kube/config、（オプションで）Helm v3。Bunランタイム（bun.sh）をインストールします。

実行 –

bun install          # 依存関係のインストール
npx mcp-server-kubernetes   # サーバーの起動（STDIOまたはSSEトランスポート）

AIクライアントに接続 – 例：Claude Desktop、VS Code MCP拡張機能、または mcp-chat CLI:
```
npx mcp-chat --server "npx mcp-server-kubernetes"
```
クライアントは自動的に現在の kubectl コンテキストを認識します。

コア機能（MCPツールとして公開）

カテゴリ	ツール（例）	説明
リソースのCRUD	`kubectl_get`, `kubectl_create`, `kubectl_apply`, `kubectl_delete`	任意のK8sオブジェクトのリスト表示、作成、YAMLの適用、削除。
検査	`kubectl_describe`, `kubectl_logs`, `explain_resource`	詳細な説明、ログの末尾取得、自然言語による説明。
管理	`kubectl_scale`, `kubectl_patch`, `kubectl_rollout`, `node_management`	デプロイメントのスケーリング、フィールドのパッチ、ロールアウトの制御、ノードのコルドン/ドレイン。
Helm	`install_helm_chart`, `upgrade_helm_chart`, `helm_template_apply`, `helm_template_uninstall`	チャートのインストール/アップグレード、またはテンプレートのレンダリング後に適用することで認証問題を回避。
ポートフォワード	`port_forward`, `stop_port_forward`	ポッド/サービスをローカルに公開。
診断	`k8s-diagnose`	問題のあるポッド向けのガイド付きトラブルシューティングフロー。
ユーティリティ	`kubectl_context`, `list_api_resources`, `ping`	コンテキストの切り替え、APIグループの一覧表示、ヘルスチェック。

すべてのツールは 非破壊モード（ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true）でフィルタリング可能で、読み取り専用および安全な作成/更新操作のみが残ります。

観測性（オプション）

環境変数で有効化：

export ENABLE_TELEMETRY=true
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
npx mcp-server-kubernetes

すべてのツール呼び出し（名前、実行時間、成功/失敗、K8sコンテキストなど）をトレースでき、任意のOTLP互換バックエンド（Jaeger、Grafana Tempo、Datadog、AWS X‑Rayなど）にエクスポート可能。
サンプリング、構成、デプロイ例については docs/OBSERVABILITY.md を参照してください。

開発と貢献

ビルド – bun run dev（ウォッチモード）、bun run test、bun run build。
ローカルテスト – Model Context Protocol inspector またはバンドルされた mcp-chat CLI を使用。
貢献 – CONTRIBUTING.md を参照；PRは歓迎です。
リリースワークフロー – GitHubで新しい vX.Y.Z タグを付与；CIが自動的にビルドし、npmパッケージを公開します。

どのような人が使うか

エディタから直接クラスタを管理できるようにしたいAI支援開発者。
安全で監査可能なKubernetes操作が求められるチャットオペスボットを構築するオペスチーム。
Claude、Cursor、またはカスタムアシスタントに接続するMCP互換バックエンドを探しているツールメーカー。

引用

プロジェクトを引用する場合、以下のBibTeXエントリを使用してください：

@software{Patel_MCP_Server_Kubernetes_2024,
  author = {Patel, Paras and Sonwalkar, Suyog},
  month = jul,
  title = {{MCP Server Kubernetes}},
  url = {https://github.com/Flux159/mcp-server-kubernetes},
  version = {2.5.0},
  year = {2024}
}