基本能力
产品定位
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