🚀 K8s人工智能助理MCP(不再工作)
一个全面的Kubernetes管理解决方案,结合了 MCP(模型上下文协议)服务器 和 Rancher用户界面扩展 用于智能、人工智能驱动的Kubernetes集群管理。
📋 目录
- 概述
- 建筑
- 组件
- 特性
- 演示
- 安装
- 用法
- 发展
- 许可证
- 致谢
🎯 概述
该项目整合了两项强大的技术,以创建无缝的Kubernetes管理体验:
- Kubernetes的MCP服务器 -Kubernetes操作的AI驱动命令界面
- Rancher用户界面扩展 -Rancher管理平台的可视化界面扩展
该组合通过统一的界面提供命令行人工智能辅助和可视化管理功能。
🔄 系统工作流
架构概述
K8s AI Assistant遵循多层架构,通过AI分析处理自然语言查询,并通过MCP协议执行Kubernetes操作。```mermaid
graph LR
A[User Input] --> B[Rancher UI]
B --> C[Backend API]
C --> D[Ollama AI]
D --> E[MCP Server]
E --> F[Kubernetes]
F --> E
E --> D
D --> C
C --> B
B --> A
style A fill:#e1f5fe
style B fill:#fff3e0
style C fill:#f3e5f5
style D fill:#e8f5e8
style E fill:#fff8e1
style F fill:#fce4ec
### 核心组件
|组件|技术|协议|端口|用途|
|-----------|------------|----------|------|---------|
| **前端** |Vue.js+Rancher Shell | HTTP/HTTPS | 8005 |用户界面和聊天体验|
| **后端API** |Express.js | HTTP | 8055 |请求路由和响应格式|
| **AI模型** |Ollama(gpt-oss:20b)|与OpenAI兼容的API | 11434|自然语言处理和意图映射|
| **MCP服务器** |Node.js+TypeScript | JSON-RPC+SSE | 3000 | Kubernetes命令执行|
| **Kubernetes** |kubectl+Helm|Kubernetes API |6443|集群管理和资源操作|
### 请求流
1. **用户提交自然语言查询** 通过Rancher UI扩展
1. **后端API** 验证请求并将其路由到AI模型
1. **成为AI** 分析意图并映射到Kubernetes操作
1. **MCP服务器** 通过JSON-RPC执行kubectl/Helm命令
1. **Kubernetes API** 返回集群数据和操作结果
1. **响应链** 通过AI格式化处理数据
1. **前端** 显示格式化结果(表格、日志、见解)
### 主要特点
- **自然语言处理**:将用户查询转换为Kubernetes命令
- **实时执行**:实时集群数据检索和操作执行
- **智能格式化**:人工智能驱动的响应格式和见解
- **安全操作**:RBAC兼容的集群访问和审计日志记录
- **可扩展架构**:模块化设计,便于添加功能
## 🏗️ 建筑```
┌─────────────────────────────────────────────────────────────┐
│ K8s AI Assistant MCP │
├─────────────────────────────────────────────────────────────┤
│ ┌─────────────────┐ ┌─────────────────────────────────┐ │
│ │ MCP Server │ │ Rancher UI Extensions │ │
│ │ (Backend) │ │ (Frontend) │ │
│ │ │ │ │ │
│ │ • kubectl ops │ │ • Visual dashboards │ │
│ │ • Helm support │ │ • Resource management UI │ │
│ │ • AI diagnosis │ │ • Real-time monitoring │ │
│ │ • Port forward │ │ • Custom extensions │ │
│ └─────────────────┘ └─────────────────────────────────┘ │
│ │ │ │
│ └───────────┬───────────────┘ │
│ │ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Kubernetes Cluster │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │
│ │ │ Pods │ │ Services │ │ Deployments │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
🔧 组件
1.Kubernetes的MCP服务器(mcp-server-kubernetes/)
分叉自: Flux159/mcp服务器kubernetes
MCP服务器通过自然语言命令和自动化操作提供人工智能驱动的Kubernetes管理。
主要特点:
- API统一库贝特尔 -完整的kubectl命令支持
- 人工智能驱动的诊断 -自动故障排除
k8s-diagnose - Helm操作 -图表管理和部署
- 端口转发 -安全访问群集服务
- 无损模式 -安全的只读操作
- 秘密掩盖 -以安全为重点的数据处理
可用命令:```bash
Resource Management
kubectl_get, kubectl_describe, kubectl_create, kubectl_apply
kubectl_delete, kubectl_scale, kubectl_patch, kubectl_rollout
Monitoring & Debugging
kubectl_logs, port_forward, k8s-diagnose
Helm Operations
install_helm_chart, upgrade_helm_chart, uninstall_helm_chart
Context Management
kubectl_context, list_api_resources, explain_resource
### 2.Rancher用户界面扩展(`rancher-ui/`)
**分叉自:** rancher/ui插件示例
Rancher UI扩展通过Rancher平台为Kubernetes资源提供可视化管理界面。
#### 主要特点:
- **可视化仪表板** -实时集群监控
- **资源管理UI** -直观的资源操作
- **自定义扩展** -可扩展插件架构
- **多集群支持** -管理多个集群
- **基于角色的访问** -安全访问控制
#### 扩展类型:
- **时钟扩展** -实时集群时间显示
- **主页扩展** -自定义仪表板视图
- **CRD扩展** -自定义资源定义
- **节点驱动程序扩展** -云提供商集成
- **顶级产品扩展** -完成产品集成
## ✨ 特性
### 人工智能驱动的管理
- 自然语言Kubernetes命令
- 自动故障排除和诊断
- 智能资源推荐
- 预测性缩放和优化
### 视觉界面
- 实时集群监控仪表板
- 拖放资源管理
- 可视化pod和服务拓扑
- 交互式日志查看
### 安全与合规
- 基于角色的访问控制(RBAC)
- 秘密管理和掩盖
- 审计日志和合规性报告
- 安全端口转发
### 多集群支持
- 跨多个集群的统一管理
- 跨集群资源监控
- 集中配置管理
- 集群健康评分
## 🎬 演示
### 演示截图
#### Rancher UI扩展接口
*Rancher UI扩展界面显示Kubernetes管理功能*
#### 其他演示内容(即将推出)
> **📸 更多演示图片**
>
> *其他屏幕截图和视频展示了K8s人工智能助手的实际应用*
>
> **计划演示内容:**
>
> - MCP服务器命令行界面
> - 人工智能驱动的故障排除工作流程
> - 多集群管理界面
> - 实时监控和警报
> - Helm图表部署过程
> - 端口转发和服务访问
> - 自定义扩展开发
### 互动演示
> **🔗 现场演示占位符**
>
> *即将推出:互动演示环境,提供实践体验*
## 🚀 安装
### 先决条件
- Kubernetes集群(本地或远程)
- Node.js 18+和npm/bun
- kubectl配置了集群访问权限
- Rancher Manager(用于UI扩展)
- Ollama服务器(用于AI模型)
### 快速开始
1. **克隆存储库:**```bash
git clone https://github.com/Thanhdeptr/K8s_AI_Assistant_MCP.git
cd K8s_AI_Assistant_MCP
- 安装MCP服务器:```bash
cd mcp-server-kubernetes
npm install
npm run build
3. **安装Rancher UI扩展:**```bash
cd ../rancher-ui
npm install
- 配置Claude桌面:```json
{
"mcpServers": {
"k8s-ai-assistant": {
"command": "node",
"args": ["/path/to/K8s_AI_Assistant_MCP/mcp-server-kubernetes/dist/index.js"]
}
}
}
5. **部署Rancher扩展:**```bash
# Build and package extensions
npm run build
npm run package
# Deploy to Rancher
helm install k8s-ai-extensions ./charts/
详细的设置说明
有关详细的设置说明,包括如何运行MCP服务器和后端服务器,请参阅 设置.md.
📖 用法
MCP服务器命令```bash
Get all pods in default namespace
kubectl_get pods
Describe a specific deployment
kubectl_describe deployment my-app
Scale a deployment
kubectl_scale deployment my-app --replicas=5
Diagnose pod issues
k8s-diagnose my-app-pod
Port forward to a service
port_forward service/my-app-service 8080:80
### Rancher用户界面扩展
1. **访问牧场经理**
1. **导航到扩展**
1. **安装K8s AI助手扩展**
1. **访问自定义仪表板和工具**
## 🛠️ 发展
### 项目结构```
K8s_AI_Assistant_MCP/
├── mcp-server-kubernetes/ # MCP Server backend
│ ├── src/ # Source code
│ ├── tests/ # Unit tests
│ └── dist/ # Built artifacts
├── rancher-ui/ # Rancher UI extensions
│ ├── pkg/ # Extension packages
│ ├── charts/ # Helm charts
│ └── assets/ # Extension assets
└── docs/ # Documentation
开发设置
- MCP服务器开发:```bash
cd mcp-server-kubernetes
npm run dev # Development mode with hot reload
npm run test # Run tests
npm run build # Build for production
2. **Rancher UI开发:**```bash
cd rancher-ui
npm run dev # Development server
npm run build # Build extensions
npm run package # Package for deployment
测试```bash
Run all tests
npm run test:all
Test MCP Server only
cd mcp-server-kubernetes && npm run test
Test UI extensions only
cd rancher-ui && npm run test
```
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
该项目建立在以下开源项目的出色工作之上:
Kubernetes的MCP服务器
- 原始存储库: Flux159/mcp服务器kubernetes
- 作者 Paras Patel和Suyog Sonwalkar
- 许可证: MIT许可证
- 说明: MCP服务器通过AI接口提供Kubernetes管理命令
Rancher UI插件示例
- 原始存储库: rancher/ui插件示例
- 作者 牧场主实验室
- 许可证: Apache 2.0
- 说明: Rancher管理平台的UI扩展示例
主要贡献者
- Flux159 -MCP服务器开发和维护
- 牧场主实验室 -UI扩展框架和示例
- 开源社区 -持续改进和反馈
⭐ 如果你觉得这个存储库有用,请为其加星!
🔄 分叉并贡献,让它变得更好!