K8s MCP

一款由Model Context Protocol (MCP) 和Google Gemini驱动的Kubernetes助手。

需求

• Python 3.10+
• 已配置kubeconfig的Kubernetes集群
• Node.js 18+（用于前端）
• Bun（可选，用于更快的前端构建）

快速开始

使用Makefile运行不同的组件：

1. MCP服务器

启动与您的Kubernetes集群通信的MCP服务器。

make mcp-server

需求：活动的Kubernetes集群和已配置的kubeconfig。

2. 命令行界面模式

交互式命令行界面，用于查询您的Kubernetes集群。

make cli

3. 网络应用程序（后端+前端）

启动后端API服务器：

make backend

在另一个终端中启动前端：

make frontend

然后在浏览器中打开http://localhost:5173。

4. 一次性启动所有服务

在后台启动所有服务（开发模式）：

make dev

项目结构

k8s_mcp_server.py    - MCP服务器实现
mcp_client.py        - 命令行客户端
app/
  backend/           - FastAPI服务器
  frontend/          - React用户界面

配置

确保您的kubeconfig位于~/.kube/config或设置KUBECONFIG环境变量。

MCP服务器提供了32个Kubernetes工具，用于管理资源、部署、服务等。

特性

• 通过MCP工具进行实时Kubernetes操作
• 显示工具调用结果的聊天界面
• 在消息中显示内联工具调用
• 使用WebSocket流进行实时响应
• 自动重新连接WebSocket

Make命令

可用的make目标（运行make <目标>）：

• make help — 显示所有可用命令
• make mcp-server — 启动K8s MCP服务器
• ``make cli` — 启动交互式CLI客户端
• make backend — 启动FastAPI后端
• make frontend — 启动React前端
• make dev — 在后台启动后端和前端（开发模式）
• make logs — 尾随服务日志
• make stop — 停止所有后台服务
• make install-deps — 安装项目依赖
• make clean — 删除构建工件和缓存文件