MCP Server Incident Pilot

MCP服务器Kubernetes

    ](https://www.docker.com/)     ](https://smithery.ai/protocol/mcp-server-kubernetes)

MCP服务器，可以连接到Kubernetes集群并对其进行管理。支持按优先级顺序从多个源加载kubeconfig。

https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed

使用Claude Desktop

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

默认情况下，服务器从以下位置加载kubeconfig ~/.kube/config。有关其他身份验证选项（环境变量、自定义路径等），请参阅 高级\_ README.md.

服务器将自动连接到您当前的kubectl上下文。确保你有：

1. kubectl已安装并位于您的PATH中
2. 已配置上下文的有效kubeconfig文件
3. 访问为kubectl配置的Kubernetes集群（例如minikube、Rancher Desktop、GKE等）
4. Helm v3已安装并位于您的PATH中（不需要Tiller）。如果您不打算使用Helm，则可以选择。

您可以通过让Claude列出您的Pod或创建测试部署来验证您的连接。

如果有错误，请打开标准终端并运行 kubectl get pods 查看您是否可以在没有凭据问题的情况下连接到集群。

使用mcp聊天

mcp聊天 是MCP服务器的CLI聊天客户端。您可以使用它与Kubernetes服务器进行交互。

npx mcp-chat --server "npx mcp-server-kubernetes"

或者，将上面的现有Claude Desktop配置文件传递给它（Linux应将正确的路径传递给config）：

雨衣：

npx mcp-chat --config "~/Library/Application Support/Claude/claude_desktop_config.json"

窗户：

npx mcp-chat --config "%APPDATA%\Claude\claude_desktop_config.json"

特性

• \[x\] 连接到Kubernetes集群
• \[x\] 用于管理资源的统一kubectl API

- 获取或列出资源 kubectl_get - 描述资源 kubectl_describe - 列出资源 kubectl_get - 创建资源 kubectl_create - 将YAML清单应用于 kubectl_apply - 删除资源 kubectl_delete - 获取日志 kubectl_logs - 使用以下命令管理kubectl上下文 kubectl_context - 解释Kubernetes资源 explain_resource - 列出API资源 list_api_resources - 通过以下方式扩展资源 kubectl_scale - 使用以下命令更新资源的字段 kubectl_patch - 使用以下工具管理部署推出 kubectl_rollout - 使用以下命令执行任何kubectl命令 kubectl_generic - 验证与的连接 ping

• \[x\] 高级操作

- 通过以下方式扩展部署 kubectl_scale （取代传统 scale_deployment) - 端口转发到Pod和服务 port_forward - 运行Helm操作 - 安装、升级和卸载图表 - 支持自定义值、存储库和版本

• \[x\] 故障排除提示(k8s-diagnose)

- 指导基于关键字和可选命名空间的Pod的系统Kubernetes故障排除流程。

• \[x\] 用于读取和仅创建/更新群集访问的无损模式
• \[x\] 安全秘密屏蔽（屏蔽敏感数据 kubectl get secrets 命令，不影响日志）

提示

MCP Kubernetes服务器包括专门的提示，以帮助进行常见的诊断操作。

k8s诊断提示

此提示为Kubernetes Pod提供了系统的故障排除流程。它接受a keyword 识别相关吊舱和可选吊舱 namespace 缩小搜索范围。 提示的输出将指导您完成自主的故障排除流程，提供识别问题、收集证据和建议补救步骤的说明。

地方发展

确保你有 bun已安装克隆仓库并安装依赖关系：

git clone https://github.com/Flux159/mcp-server-kubernetes.git
cd mcp-server-kubernetes
bun install

开发工作流程

1. 在开发模式下启动服务器（监视文件更改）：

bun run dev

1. 运行单元测试：

bun run test

1. 构建项目：

bun run build

1. 本地测试 检查员

npx @modelcontextprotocol/inspector node dist/index.js
# Follow further instructions on terminal for Inspector link

1. 使用Claude Desktop进行本地测试

{
  "mcpServers": {
    "mcp-server-kubernetes": {
      "command": "node",
      "args": ["/path/to/your/mcp-server-kubernetes/dist/index.js"]
    }
  }
}

1. 本地测试 mcp聊天

bun run chat

贡献

请参阅 贡献.md 文件以获取详细信息。

高级

无损模式

您可以在非破坏性模式下运行服务器，该模式禁用所有破坏性操作（删除Pod、删除部署、删除命名空间等）：

ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS=true npx mcp-server-kubernetes

对于具有非破坏性模式的Claude Desktop配置：

{
  "mcpServers": {
    "kubernetes-readonly": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"],
      "env": {
        "ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS": "true"
      }
    }
  }
}

无损模式下可用的命令

所有只读和资源创建/更新操作仍然可用：

• 资源信息： kubectl_get, kubectl_describe, kubectl_logs, explain_resource, list_api_resources
• 资源创建/修改： kubectl_apply, kubectl_create, kubectl_scale, kubectl_patch, kubectl_rollout
• Helm操作： install_helm_chart, upgrade_helm_chart
• 连接性： port_forward, stop_port_forward
• 上下文管理： kubectl_context

在非破坏性模式下禁用命令

以下破坏性操作已禁用：

• kubectl_delete：删除任何Kubernetes资源
• uninstall_helm_chart：卸载Helm图表
• cleanup：清理管理资源
• kubectl_generic：常规kubectl命令访问（可能包括破坏性操作）

有关其他高级功能，请参阅 高级\_ README.md.

建筑

看这个 DeepWiki链接 了解Devin创建的更深入的架构概述。

本节介绍MCP Kubernetes服务器的高级架构。

请求流

下面的序列图说明了请求如何在系统中流动：

sequenceDiagram
    participant Client
    participant Transport as Transport Layer
    participant Server as MCP Server
    participant Filter as Tool Filter
    participant Handler as Request Handler
    participant K8sManager as KubernetesManager
    participant K8s as Kubernetes API

    Note over Transport: StdioTransport or
SSE Transport

    Client->>Transport: Send Request
    Transport->>Server: Forward Request

    alt Tools Request
        Server->>Filter: Filter available tools
        Note over Filter: Remove destructive tools
if in non-destructive mode
        Filter->>Handler: Route to tools handler

        alt kubectl operations
            Handler->>K8sManager: Execute kubectl operation
            K8sManager->>K8s: Make API call
        else Helm operations
            Handler->>K8sManager: Execute Helm operation
            K8sManager->>K8s: Make API call
        else Port Forward operations
            Handler->>K8sManager: Set up port forwarding
            K8sManager->>K8s: Make API call
        end

        K8s-->>K8sManager: Return result
        K8sManager-->>Handler: Process response
        Handler-->>Server: Return tool result
    else Resource Request
        Server->>Handler: Route to resource handler
        Handler->>K8sManager: Get resource data
        K8sManager->>K8s: Query API
        K8s-->>K8sManager: Return data
        K8sManager-->>Handler: Format response
        Handler-->>Server: Return resource data
    end

    Server-->>Transport: Send Response
    Transport-->>Client: Return Final Response

看这个 DeepWiki链接 了解Devin创建的更深入的架构概述。

发布新版本

转到 发布页面，单击“草稿新版本”，单击“选择标签”，然后使用“v{major}.{minor}.{patch}”semver格式键入新版本号来创建新标签。然后，如有必要，写一个发布标题“release v｛major｝.｛minor｝.｛patch｝”和描述/更改日志，然后单击“发布发布”。

这将创建一个新标记，该标记将通过cd.yml工作流触发新的版本构建。一旦成功，新版本将发布到 请注意，不需要手动更新package.json版本，因为工作流会自动更新package.json文件中的版本号并将提交推送到main。

未计划的

向kubectx添加集群。

明星历史


🖊️ 引用

如果你觉得这个仓库有用，请引用：

@software{Patel_MCP_Server_Kubernetes_2024,
author = {Patel, Paras and Sonwalkar, Suyog},
month = jul,
title = {{MCP Server Kubernetes}},
url = {https://github.com/Flux159/mcp-server-kubernetes},
version = {2.5.0},
year = {2024}
}