mcp-kubernetes

一个适用于 Kubernetes 的 Model Context Protocol 服务器。它让支持 MCP 的客户端（Claude Desktop、Claude Code 等）能够跨多个上下文（context）查看并操作 Kubernetes 集群，行为完全由标志（flag）控制。

设计目标是默认安全（safe by default）：默认以只读（read-only）模式启动，可以通过命名空间和上下文的允许列表（allowlist）限制范围，保护系统命名空间不被修改，并将危险操作（delete、apply、exec）置于显式 opt-in 门槛之后。

功能

• 多集群 — 每个工具都接受一个可选的 context 参数；可通过允许列表指定可用的上下文。

• 访问模式 — read-only → read-write → admin 逐层递进，任何模式都不会暴露其级别之上的工具。

• 安全标志 — 命名空间允许列表、受保护命名空间、上下文允许列表，此外还有针对 delete / apply / exec 的独立 opt-in，以及 dry-run 和 JSON 审计日志（见下文）。

• 标准认证 — 使用你的 kubeconfig（或集群内 service account），服务器不会存储任何凭据。

Related MCP server: k8s-mcp-go

安全模型

安全层级彼此独立——例如，三个 opt-in 全部为 false 的 admin 模式下，可以实现 Deployment 重启和扩缩容，但不能删除了也不能执行 delete 或 exec。

工具

读取（read-only+）：list_contexts、list_namespaces、list_pods、get_pod、get_pod_logs、list_deployments、list_services、list_nodes、list_events、get_resource

写入（read-write+）：scale_deployment、restart_deployment、set_deployment_image、create_namespace、apply_manifest（需要 K8S_ALLOW_APPLY）

管理（admin）：delete_resource（需要 K8S_ALLOW_DELETE）、exec_in_pod（需要 K8S_ALLOW_EXEC）

与你的 MCP 客户端搭配使用

支持 Claude Code、Claude Desktop、Cursor、OpenAI Codex CLI、Windsurf、VS Code（Copilot）以及任何其他 MCP 客户端——各客户端的配置方式请参阅 docs/CLIENTS.md。

安装

npm install
npm run build

使用 Claude Desktop / Claude Code 运行

将其添加到你的 MCP 客户端配置：

{
  "mcpServers": {
    "kubernetes": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-kubernetes/dist/index.js"],
      "env": {
        "KUBECONFIG_PATH": "/Users/you/.kube/config",
        "K8S_MODE": "read-only",
        "K8S_CONTEXT_ALLOWLIST": "staging",
        "K8S_NAMESPACE_ALLOWLIST": "app,web"
      }
    }
  }
}

如需扩缩容或重启，则将 K8S_MODE 调整为 read-write；只有当你确实想要允许删除或 exec 时，才将其调整为 admin（并设置相应的 K8S_ALLOW_* 标志）。

开发

npm run dev        # watch mode
npm test           # unit tests for the security policy
npm run typecheck

发布

该服务器提供了一份用于官方 MCP 注册表的 server.json，以及用于 npm 所有权验证的 mcpName。有关发布到 npm 以及在 MCP registry、Smithery、Glama、Cursor 和 PulseMCP 上架的说明，请参阅 PUBLISHING.md。

许可证

MIT