Kubernetes 故障手册服务

解决什么问题

Kubernetes 集群的故障手册往往散落在内部 Wiki、Git 仓库和各个团队的文档里。当 Pod 陷入 CrashLoopBackOff、Service 没有 endpoints、或者 PVC 一直 Pending 时，工程师需要快速定位对应的处理手册，而不是临时翻找。这个技能把 Kubernetes 故障排除手册封装成 MCP 服务器，让 AI 助手在排查过程中直接按关键词搜索、按主题拉取手册正文。

核心能力

技能本身充当路由层：理解用户意图、选择工具、提取参数，代码只负责调用 API。

• search_runbooks：按关键词搜索手册，必填参数 query
• fetch_runbook：按主题 slug 获取单篇手册，必填参数 topic
• list_topics：列出当前可用的全部手册主题，无参数

工具返回 dict 对象：result["raw"] 是 API 原始 JSON 数据，整理后展示给用户；result["success"] 与 result["message"] 用于判断调用是否成功。

工作流程

1. 检查密钥：若 scripts.config.settings.api_key 为空，必须先向用户询问，拿到后调用 scripts.config.set_api_key(key) 保存
2. 选择工具：根据用户意图从三个工具中选一个
3. 提取参数：必填参数缺失时，同样要向用户追问
4. 调用工具：使用关键字参数调用 scripts.tools 中的函数
5. 返回结果：整理 raw 数据后输出给用户

注意点

• API 密钥是硬性前提，缺失时禁止自行搜索或编造手册内容
• 参数不完整时不能猜测，必须先问用户
• 本服务只做手册检索与内容获取，实际的集群操作仍需工程师在环境里执行