Kubeview MCP

🚀 KubeView MCP – Kubernetes模型上下文协议服务器

KubeView 是一个只读的模型上下文协议（MCP）服务器，它能让AI代理（如Cursor IDE、Claude Code CLI、Codex CLI、Gemini CLI等）安全地检查、诊断和调试Kubernetes集群。它为Kubernetes、Helm、Argo Workflows和Argo CD提供了一套全面的工具。 想了解更多关于代码模式的好处和实现方式，请阅读 从Kubernetes集群中排除MCP工具调用。

✨ 主要特性

• 🧠 代码模式：提供沙盒化的TypeScript环境，适用于复杂推理和多步骤工作流。
• 🛡️ 只读且安全：专为生产环境安全设计，无写入权限，并对敏感数据进行掩码处理。
• ☸️ Kubernetes集成：可列出/获取资源、获取指标、流式传输日志和事件、执行命令，还具备诊断网络问题的工具。
• 📦 Helm支持：可检查版本、值、清单和历史记录。
• 🐙 Argo生态系统：可使用直接的Kubernetes API或CLI管理Argo Workflows和Argo CD应用程序。

🚀 快速开始

前提条件

• Node.js ≥ 18
• 能够访问Kubernetes集群
• 可选择在当前$PATH中安装以下CLI工具：helm、argo、argocd

安装

# 启动服务器
npx -y kubeview-mcp

# 作为Claude代码MCP服务器安装
claude mcp add kubernetes -- npx kubeview-mcp

MCP客户端配置

将以下内容添加到你的mcpServers配置中（例如在Cursor或Claude Desktop中）：

{
  "mcpServers": {
    "kubeview": {
      "command": "npx",
      "args": ["-y", "kubeview-mcp"]
    }
  }
}

环境变量

使用环境变量配置服务器：

🛠️ 工具概述

Kubernetes

• kube_list：列出资源或获取集群诊断信息。
• kube_get：描述特定资源（支持所有K8s类型）。
• kube_metrics：获取节点和Pod的CPU/内存指标。
• kube_logs：获取或流式传输容器日志。
• kube_exec：在容器中执行命令（建议只读）。
• kube_port：端口转发到Pod/服务。
• kube_net：运行集群内网络诊断。

Helm

• helm_list：列出Helm版本。
• helm_get：获取版本值、清单和历史记录。

Argo

• argo_list / argo_get：管理Argo Workflows。
• argocd_app：检查Argo CD应用程序和资源。

实用工具

• run_code：执行沙盒化的TypeScript代码以处理复杂任务。

🧠 代码模式

受 使用MCP执行代码 的启发，KubeView附带了一个代码模式运行时，允许代理在沙盒环境中探索API、搜索工具并执行复杂的工作流。

提供的功能

• MCP桥接层：无缝连接到所有已注册的MCP服务器工具。
• 动态TypeScript定义：自动将工具模式转换为强类型的global.d.ts资源，使代理能够使用有效的TypeScript模式，并在不产生参数幻觉的情况下享受类型安全。
• 工具搜索实用程序：运行时辅助工具，如tools.search()和tools.list()，允许代理逐步发现功能，而无需事先加载整个模式上下文。
• 沙盒执行：通过vm实现的受限Node.js环境，对console和tools全局对象进行了访问控制，确保安全执行代理生成的代码。

使用方法

对于需要逻辑、循环或数据处理的复杂任务，请使用 代码模式：

"env": { "MCP_MODE": "code" }

💡 代码模式提示技巧

服务器包含一个名为 code-mode 的内置提示，它会将完整的TypeScript API文档、工具概述和示例注入到上下文中。

在Cursor IDE中： 只需在提示框中输入/kubeview/code-mode（或从/提示菜单中选择）。这将为AI提供编写正确run_code脚本所需的确切上下文。

💻 本地开发

1. 克隆并安装：

git clone https://github.com/mikhae1/kubeview-mcp.git
cd kubeview-mcp
npm install

2. 构建并运行：

npm run build
npm start

3. 测试：

npm test

CLI使用方法

你可以通过CLI直接测试工具：

npm run command -- kube_list --namespace=default

📄 许可证

本项目采用MIT许可证，版权归 mikhae1 所有。