kube-noob

Name: kube-noob
Author: aashishmahajan

本地服务

github.com云与基础设施0今天更新

代码仓库访问官网

关于 kube-noob

kube-noob 提供 Kubernetes、OpenShift、ROSA HCP、Helm 和 RHACS 的审计、调试、文档及练习，不内置 AI 模型。它面向通过 MCP 客户端或命令行工作的运维人员和学习者，提供优先只读的操作手册及带引用的本地知识。

主要功能

01审计规则与加固清单生成
02离线调试操作手册
03带引用的本地文档
04分级学习路线与练习
05只读集群证据，不读取 Secrets
06无需 AI 模型的命令行运行

适用场景

01审计 Kubernetes 或 OpenShift 清单
02使用离线手册排查错误
03解释策略拒绝和网络可达性
04通过分级练习学习平台运维

MCP 相关

它向 MCP 客户端提供审计、调试等工具，包括 Claude 和 OpenShift Lightspeed。启用后可使用集群及网页工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 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 客户端都可以将其作为工具调用；命令行则完全不依赖 AI 运行。除非你主动启用，否则它不会发起网络请求。

审计：60 条规则和严格的模式（Kubernetes 1.35、Routes、SCCs、EgressFirewall、Gateway API、StackRox），已移除 API 检查、安全自动修复、9 个红队场景，以及 RHACS 策略映射。
生成：生成经过加固的清单和 Helm chart，返回前再次审计。
调试：38 份离线操作手册，优先执行只读步骤；列出 OpenShift 已报告的漏洞及其修复版本；解释策略拒绝（Kyverno、Gatekeeper、Pod Security、SCC、RBAC）；分析 NetworkPolicy 可达性；提供只读集群证据（绝不包含 Secrets）。
学习：5 条学习路径、16 节课程和分级练习；在本地记住已确认的修复方法。
引用：回答会引用本地知识，格式为 [kn:<doc>#<n>]。

每个设计请求都会遵循 7 步协议：澄清、验证、研究、审计、校准、生成、红队测试。

谁负责思考

你使用的方式	由谁回答	什么内容会离开你的设备
Claude 插件（Claude Code、Cowork）	Claude 调用 kube-noob 的工具	你分享给 Claude 的内容，与任何聊天相同；kube-noob 不发送任何内容
OpenShift Lightspeed 或其他 MCP 客户端	该客户端使用的模型	该客户端发送给模型的内容；kube-noob 不发送任何内容
命令行	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 插件，可在 Claude Code 中使用（需要 uv）：

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

在 claude.ai 或桌面应用中：自定义 > 插件 > 添加 > 添加市场，aashishmahajan/kube-noob。

任何 MCP 客户端：

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

启用集群和 Web 工具后，它们就会显示。

在 OpenShift 上运行

可作为受令牌保护的服务、仅限本地回环的 sidecar，或供 OpenShift Lightspeed 使用的工具： docs/openshift.md。该 chart 提供 NetworkPolicies，并以 restricted-v2 身份运行。

默认安全

设置	默认值	修改方式
Web 查询（HTTPS GET、允许列表中的文档、仅文本）	关闭	`webEnabled: true` / `KUBE_NOOB_WEB_ENABLED=true`
管理员离线锁定（覆盖 Web，仅限本地模型）	关闭	`offline: true` / `KUBE_NOOB_OFFLINE=1` / chart `config.offline`
实时集群（只读，不含 Secrets）	关闭	`cluster.enabled: true` / `--cluster-enabled`
本地学习文件（配置文件、已确认的笔记）	开启	`learningEnabled: false`
仅用于 `kube-noob ask` 的模型	无	`llm.provider: anthropic`（`kube-noob[ask]`）或 `openai-compatible`