K8s MCP

K8s MCP

由模型上下文协议（MCP）和Google Gemini支持的Kubernetes助手。

需求

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

快速开始

使用Makefile运行不同的组件：

1.MCP服务器

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

make mcp-server

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

2.CLI模式

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

make cli

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

启动后端API服务器：

make backend

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

make frontend

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

4.一下子

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

make dev

项目结构

k8s_mcp_server.py    - MCP server implementation
mcp_client.py        - CLI client
app/
  backend/           - FastAPI server
  frontend/          - React UI

配置

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

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

特性

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

发出命令

可用目标（运行 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 --删除构建工件和缓存文件