Kubernetes故障手册服务

Kubernetes Runbook MCP服务器

一个模型上下文协议（MCP）服务器，提供对Kubernetes故障排除运行手册的访问 容器解决方案运行手册.

特性

• 🔍 搜索与发现：按关键字查找相关的Runbook或浏览所有可用的主题
• 📖 内容访问：获取特定Kubernetes问题的详细故障排除指南
• 🤖 人工智能集成：设计用于通过MCP与AI助手无缝集成
• ⚡ 演出：智能缓存，最大限度地减少网络请求
• 🛡️ 可靠性：强大的错误处理和优雅的降级

可用的Runbook

服务器提供对以下内容的全面故障排除指南的访问：

• 节点问题：资源限制、节点可用性问题
• Pod问题：CrashLoopBackOff、ImagePullBackOff、挂起状态
• 容器错误：CreateContainerError，沙盒创建失败
• 网络问题：服务连接、DNS解析问题
• 资源管理：OutOfPod状态，资源分配问题

安装

使用uvx（推荐）

直接安装并运行uvx：

uvx kubernetes-runbooks-mcp-server

使用紫外线

uv tool install kubernetes-runbooks-mcp-server
kubernetes-runbooks-server

使用pip

pip install kubernetes-runbooks-mcp-server
kubernetes-runbooks-server

用法

使用克劳德桌面

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "kubernetes-runbooks": {
      "command": "uvx",
      "args": ["kubernetes-runbooks-mcp-server"]
    }
  }
}

可用工具

• list-topics：列出所有可用的runbook主题
• search-runbooks：按关键字搜索Runbook
• fetch-runbook：按主题段获取特定runbook内容

可用资源

通过URI直接访问Runbook：

• runbook://kubernetes/create-container-error
• runbook://kubernetes/crashloopbackoff
• runbook://kubernetes/dns-failures

可用提示

• troubleshoot-k8s：交互式故障排除指南
• runbook-summary：总结运行手册中的要点

示例用法

# List all available topics
{"name": "list-topics", "arguments": {}}

# Search for pod-related issues
{"name": "search-runbooks", "arguments": {"query": "pod"}}

# Fetch specific runbook
{"name": "fetch-runbook", "arguments": {"topic": "crashloopbackoff"}}

发展

设置

git clone <repository-url>
cd kubernetes-runbooks-mcp-server
uv sync --dev

跑步

uv run kubernetes-runbooks-server

测试

uv run pytest

建筑

• RunbookScraper：处理从Runbook网站抓取网页
• 缓存系统：runbook元数据和内容的内存缓存
• MCP服务器：使用资源、工具和提示实现模型上下文协议

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

致谢

• 集装箱解决方案 用于维护优秀的Kubernetes运行手册
• 模型上下文协议 对于MCP规范