K8s MCP Server
2025.04.16
70
PythonKubernetes 管理命令行工具安全执行开发效率
K8s MCP Server 是一个基于 Anthropic 的 MCP（Model Context Protocol）协议的服务器，旨在为语言模型（如 Claude）提供安全、容器化的 Kubernetes CLI 工具执行环境。它充当语言模型与 Kubernetes CLI 工具（如 kubectl、istioctl、helm 和 argocd）之间的安全桥梁，允许语言模型执行经过验证的 Kubernetes 命令、检索命令文档并以结构化方式处理命令输出。
View on GitHub
Overview
基本能力
产品定位
K8s MCP Server 是一个安全、高性能且可扩展的服务器，旨在为语言模型提供与 Kubernetes CLI 工具的安全交互能力。
核心功能
- 安全执行 Kubernetes CLI 命令，包括
kubectl、istioctl、helm和argocd - 支持命令管道功能，可与流行的 Linux CLI 工具结合使用
- 详细的命令验证和安全检查
- 可配置的超时和输出限制
- 全面的文档和帮助检索
- 上下文和命名空间管理
- 预构建的提示模板，用于常见的 Kubernetes 操作
适用场景
- 通过语言模型（如 Claude）管理和操作 Kubernetes 集群
- 自动化 Kubernetes 部署和故障排除
- 教育和学习 Kubernetes 命令和操作
- 开发和测试 Kubernetes 应用程序
工具列表
kubectl: Kubernetes 命令行工具istioctl: Istio 服务网格命令行工具helm: Kubernetes 包管理器argocd: GitOps 持续交付工具
常见问题解答
- 如何配置安全模式？
通过环境变量
K8S_MCP_SECURITY_MODE设置为strict（默认）或permissive。 - 如何自定义安全规则？
创建 YAML 配置文件并通过
K8S_MCP_SECURITY_CONFIG环境变量指定路径。 - 如何集成到 Claude Desktop？ 编辑 Claude Desktop 的配置文件，添加 K8s MCP Server 的 Docker 运行命令。
使用教程
使用依赖
- Docker 安装在系统上
- 有效的 Kubernetes 配置文件
~/.kube/config - Claude Desktop 应用程序
安装教程
- 拉取 Docker 镜像:
bash docker pull ghcr.io/alexei-led/k8s-mcp-server:latest - 运行 Docker 容器:
bash docker run -i --rm -v ~/.kube:/home/appuser/.kube:ro ghcr.io/alexei-led/k8s-mcp-server:latest
调试方式
- 启用调试日志:
bash export LOGLEVEL=DEBUG python -m k8s_mcp_server - 使用 MCP Inspector:
bash pip install "mcp[cli]" mcp dev src/k8s_mcp_server/server.py