kube-noob

Name: kube-noob
Author: aashishmahajan

ローカル

github.comクラウド・インフラ0今日更新

リポジトリ公式サイト

kube-noob について

kube-noobは、AIモデルを内蔵せずにKubernetes、OpenShift、ROSA HCP、Helm、RHACSの監査、デバッグ、ドキュメント、演習を提供します。MCPクライアントやコマンドラインを使う運用担当者や学習者向けで、読み取り優先の手順書と出典付きのローカルナレッジが特徴です。

主な機能

01監査ルールと堅牢化マニフェスト
02オフラインのデバッグ手順書
03出典付きローカルドキュメント
04段階別の学習トラックと演習
05Secretsを除く読み取り専用のクラスタ証拠
06AIモデル不要のコマンドライン実行

活用シーン

01KubernetesまたはOpenShiftのマニフェストを監査
02オフライン手順書でエラーを調査
03ポリシー拒否とネットワーク到達性を説明
04段階別演習でプラットフォーム運用を学習

MCP 対応

ClaudeやOpenShift Lightspeedを含むMCPクライアントに、監査やデバッグなどのツールを提供します。クラスタツールとWebツールは有効化すると利用できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "aashishmahajan-kube-noob": {
      "command": "uvx",
      "args": [
        "kube-noob"
      ],
      "env": {
        "KUBE_NOOB_WEB_ENABLED": "<KUBE_NOOB_WEB_ENABLED>",
        "KUBE_NOOB_CLUSTER_ENABLED": "<KUBE_NOOB_CLUSTER_ENABLED>",
        "KUBE_NOOB_OFFLINE": "<KUBE_NOOB_OFFLINE>"
      }
    }
  }
}

起動コマンドuvx kube-noob

設定が必要な環境変数

KUBE_NOOB_WEB_ENABLEDAllow allowlisted web lookups (default false: offline)

KUBE_NOOB_CLUSTER_ENABLEDEnable read-only live cluster tools using your kubectl/oc context (default false)

KUBE_NOOB_OFFLINEAdmin lock: no web, no downloads, local models only (default false)

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypikube-noob0.6.0stdio

ツール

掲載時のツール一覧 · 今日に更新

パラメーター	型	必須	説明
request	string	はい	ユーザーが自分の言葉で説明する要望。
version	any	いいえ
platform	any	いいえ
blueprint	any	いいえ	ジェネレーターブループリント（generate_manifests を参照）。
manifests	any	いいえ	レビュー対象の既存マニフェスト。
apply_fixes	boolean	いいえ

詳細

kube-noob

AIは内蔵していません。お使いのAIと連携します。 kube-noobは、Kubernetes、OpenShift、ROSA HCP、Helm、RHACS/StackRoxのエキスパートを一つにまとめたツールです。監査ルール、読み取り専用を優先するプレイブック、出典付きドキュメント、採点付き演習を備えています。Claude、OpenShift Lightspeed、または任意のMCPクライアントからツールとして呼び出せます。CLIはAIなしで実行できます。有効にしない限り、ネットワーク接続は行いません。

監査：60のルールと厳格なスキーマ（Kubernetes 1.35、Routes、SCCs、EgressFirewall、Gateway API、StackRox）、削除済みAPIのチェック、安全な自動修正、9つのレッドチームシナリオ、RHACSポリシーのマッピング。
生成：強化されたマニフェストとHelmチャートを生成し、返す前に再監査します。
デバッグ：38のオフラインプレイブック（読み取り専用の手順を優先）、報告されたOpenShiftのバグと修正バージョン、ポリシーによる拒否の説明（Kyverno、Gatekeeper、Pod Security、SCC、RBAC）、NetworkPolicyの到達可能性、読み取り専用のクラスター証跡（Secretsは決して取得しません）。
学習：5つのトラック、16のレッスン、採点付き演習を用意し、確認済みの修正をローカルに記録します。
出典：ローカルのナレッジを引用し、回答に[kn:<doc>#<n>]を付けます。

設計に関するリクエストは、Clarify、Validate、Research、Audit、Calibrate、Generate、Red Teamの7段階のプロトコルで処理します。

誰が考えるのか

使用するもの	回答するもの	マシンから送信されるもの
Claudeプラグイン（Claude Code、Cowork）	kube-noobのツールを呼び出すClaude	通常のチャットと同様、Claudeに共有した内容。kube-noobからは何も送信されません
OpenShift Lightspeedまたはその他のMCPクライアント	そのクライアントのモデル	クライアントがモデルに送信する内容。kube-noobからは何も送信されません
CLI	モデルを使わないkube-noobのルール	何も送信されません
`kube-noob ask`（任意）	設定したモデル：Anthropicまたはローカルモデル	質問はそのモデルだけに送信されます

クイックスタート

brew tap aashishmahajan/kube-noob https://github.com/aashishmahajan/kube-noob
brew trust --formula aashishmahajan/kube-noob/kube-noob
brew install kube-noob
kube-noob demo --list
kube-noob audit -f k8s/ --platform openshift --version 4.22
kube-noob diagnose 'paste events or errors'
kube-noob doctor
kube-noob selftest

短縮形はnoobです。Homebrewを使わない場合は、uv tool install kube-noobまたはpipx install kube-noobを実行してください（Python 3.11以降。macOSに組み込まれている3.9は対象外です）。エラーについてはインストールをご覧ください。役割とデモについてはユースケースをご覧ください。

Claudeまたは任意のMCPクライアントで使用する

Claude CodeでClaudeプラグインを使用します（uvが必要です）。

/plugin marketplace add aashishmahajan/kube-noob
/plugin install kube-noob@kube-noob

claude.aiまたはデスクトップアプリでは、Customize > Plugins > Add > Add marketplaceを選択し、aashishmahajan/kube-noobを指定します。

任意のMCPクライアントで使用する場合：

{"mcpServers": {"kube-noob": {"command": "uvx", "args": ["--from", "kube-noob==0.4.0", "kube-noob", "mcp"]}}}

有効にすると、クラスターおよびWebツールが表示されます。

OpenShiftで実行する

トークンで保護されたサービス、ループバック専用サイドカー、またはOpenShift Lightspeed用のツールとして実行する方法については、docs/openshift.mdをご覧ください。チャートにはNetworkPoliciesが含まれ、restricted-v2で実行されます。

デフォルトで安全

設定	デフォルト	変更方法
Web 検索（HTTPS GET、許可リストに登録されたドキュメント、テキストのみ）	オフ	`webEnabled: true` / `KUBE_NOOB_WEB_ENABLED=true`
管理者によるオフラインロック（Web を無効化し、ローカルモデルのみ使用）	オフ	`offline: true` / `KUBE_NOOB_OFFLINE=1` / chart `config.offline`
ライブクラスター（読み取り専用、Secret なし）	オフ	`cluster.enabled: true` / `--cluster-enabled`
ローカル学習ファイル（プロファイル、確認済みのメモ）	オン	`learningEnabled: false`
`kube-noob ask` 専用のモデル	なし	`llm.provider: anthropic`（`kube-noob[ask]`）または `openai-compatible`

kube-noob doctor はアクセス可能な対象を表示します。設定がカレントディレクトリから暗黙的に読み込まれることはありません。すべてのキーについては、kube-noob.example.yaml を参照してください。

ドキュメント

クレジット

クレジット対象のソース：THIRD_PARTY_NOTICES.md。Kubernetes、OpenShift、Helm、 ROSA、RHACS、StackRox は各所有者の商標です。kube-noob は独立したプロジェクトであり、これらの所有者から承認を受けていません。 Apache-2.0 の下でライセンスされています。

Markdown 対応

ログインしてコメント

基本情報

作者: aashishmahajan
言語: python
バージョン: 0.6.0
トランスポート: stdio
掲載日: 2026年10月29日
最終更新: 今日
公式 Registry: io.github.aashishmahajan/kube-noob

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

kube-noob

kube-noob について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

kube-noob

誰が考えるのか

クイックスタート

Claudeまたは任意のMCPクライアントで使用する

OpenShiftで実行する

デフォルトで安全

ドキュメント

クレジット

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？