K8s AI Assistant MCP

MCPAI代理

提供方 Thanhdeptr

AI代理 未标注 无需鉴权 社区 / 第三方 Claude

结合MCP服务器和Rancher UI扩展的Kubernetes管理解决方案,提供AI驱动的集群管理和可视化界面。

一句话选型结论

按资料字段整理

K8s AI Assistant MCP 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Kubernetes管理TypeScript本地部署AI助手集群运维可视化界面Rancher扩展

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
K8s AI Assistant MCP当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Thanhdeptr上游标注的维护方 Thanhdeptr
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.3 KB
来自项目仓库与上游目录的原文,未做删改

🚀 K8s人工智能助理MCP(不再工作)

一个全面的Kubernetes管理解决方案,结合了 MCP(模型上下文协议)服务器 和 Rancher用户界面扩展 用于智能、人工智能驱动的Kubernetes集群管理。

📋 目录

  • 概述
  • 建筑
  • 组件
  • 特性
  • 演示
  • 安装
  • 用法
  • 发展
  • 许可证
  • 致谢

🎯 概述

该项目整合了两项强大的技术,以创建无缝的Kubernetes管理体验:

  1. Kubernetes的MCP服务器 -Kubernetes操作的AI驱动命令界面
  2. 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
  1. 安装MCP服务器:```bash
    cd mcp-server-kubernetes
    npm install
    npm run build

3. **安装Rancher UI扩展:**```bash
cd ../rancher-ui
npm install
  1. 配置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

开发设置

  1. 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扩展框架和示例
  • 开源社区 -持续改进和反馈

⭐ 如果你觉得这个存储库有用,请为其加星!

🔄 分叉并贡献,让它变得更好!

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
K8s AI Assistant MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

K8s AI Assistant MCP 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

K8s AI Assistant MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

K8s AI Assistant MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

K8s AI Assistant MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

K8s AI Assistant MCP 能提供哪些能力?

资料显示能力标签包括 Kubernetes管理、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。