Kubernetes诊断MCP服务器
一种专门为以下目的设计的模型上下文协议(MCP)服务器 智能Kubernetes故障排除和诊断。旨在通过高级调试功能补充现有的K8s管理工具。
🚀 特性
高级诊断
- Pod健康分析:通过智能建议深入检查吊舱问题
- 群集运行状况概述:综合集群健康评估
- 日志分析:pod日志中的自动错误模式检测
- 工作量建议:部署和服务的最佳实践建议
智能故障排除
- 识别常见问题:CrashLoopBackOff、ImagePullBackOff、资源限制
- 根据错误模式提供上下文建议
- 分析重启次数、资源使用情况和配置问题
- 将事件与pod问题相关联
为生产而建
- 适用于任何Kubernetes集群(集群内或外部)
- 支持kubeconfig和集群内身份验证
- 全面的错误处理和记录
- 遵循Kubernetes客户端最佳实践
🛠 安装
先决条件
- 转到1.21+
- 访问Kubernetes集群
- kubectl在K8s集群内配置或运行
从源代码构建
git clone
cd k8s-diagnostics-mcp
go mod tidy
go build -o k8s-diagnostics-mcp配置
服务器会自动检测您的Kubernetes配置:
- 集群内:在K8s内运行时使用服务帐户
- 本地:用途
~/.kube/config或$KUBECONFIG环境变量
🔧 可用工具
diagnose_pod
诊断特定Kubernetes pod的问题。
参数:
pod_name(必填):要诊断的吊舱名称namespace(可选):Kubernetes命名空间(默认值:“default”)
退货:
- 吊舱状态和相位信息
- 容器重启计数和就绪状态
- 已识别的问题和明智的建议
- 最近与pod相关的事件
- 资源配置分析
analyze_cluster_health
分析Kubernetes集群的整体健康状况并找出问题。
退货:
- 节点计数和健康状态
- 命名空间计数
- 有诊断问题的Pod列表
- 资源使用概述
- 整组建议
get_workload_recommendations
获取改进工作负载配置的建议。
参数:
namespace(可选):要分析的Kubernetes命名空间(默认值:“default”)
退货:
- 部署的最佳实践建议
- 资源限制建议
- 高可用性建议
analyze_pod_logs
获取并分析pod日志以了解常见的错误模式。
参数:
pod_name(必填):吊舱名称namespace(可选):Kubernetes命名空间(默认值:“default”)container(可选):特定容器名称lines(可选):要检索的日志行数(默认值:100)
退货:
- 原始日志输出
- 检测到的错误模式
- 基于错误的上下文建议
- 日志分析摘要
📚 资源
k8s://troubleshooting/common-issues
为常见的Kubernetes问题提供全面的故障排除指南,包括:
- CrashLoopBackOff调试
- ImagePullBackOff分辨率
- 待定的pod问题
- 性能故障排除
- 网络问题诊断
🎯 用例
DevOps工程师
- 事件期间快速诊断吊舱问题
- 集群健康监测和警报
- 自动化故障排除工作流程
- 最佳实践合规性检查
对于平台团队
- 标准化故障排除程序
- 通过人工智能辅助调试实现知识共享
- 主动发现问题
- 开发人员自助调试
用于人工智能辅助操作
- 与ChatGPT、Claude或其他LLM集成
- 自然语言故障排除查询
- 自动事件响应
- 智能警报关联
🌟 是什么让这个独一无二
与专注于基本集群管理的现有Kubernetes MCP服务器不同,此服务器专门用于:
- 智能问题检测:超越了简单的状态检查,以确定根本原因
- 上下文建议:根据特定的错误模式提供可操作的建议
- 日志分析:自动解析和分析日志中的常见问题
- 生产准备就绪:考虑到企业Kubernetes环境而构建
- CNCF生态系统整合:设计用于与其他CNCF工具和最佳实践配合使用
🤝 贡献
我们欢迎捐款!该项目符合我们对CNCF生态系统和开源社区的承诺。
发展
# Run locally
go run main.go
# Run tests
go test ./...
# Build for production
go build -ldflags="-s -w" -o k8s-diagnostics-mcp📞 支持
- 项目博客:查看我们的 技术博客 K8s最佳实践
- GitHub问题:报告错误和功能请求
- CNCF社区:与更广泛的Kubernetes社区互动
🏷 许可证
\[全部\]
______________________________________________________________________
内置于❤️ 对于CNCF社区
