基本能力
产品定位
Kubernetes MCP Server 是一个用于 Kubernetes 集群的 AI 交互工具，旨在通过自然语言简化 Kubernetes 操作和管理。
核心功能
- 🔍 检索和分析集群资源
- 📈 监控部署、Pod 和服务
- 🛠️ 通过 AI 接口执行常见的 kubectl 操作
- 🔧 使用 AI 辅助排查集群问题
适用场景
- 开发者通过自然语言与 Kubernetes 集群交互
- 运维人员监控和管理集群状态
- AI 工具集成 Kubernetes 操作
工具列表
资源操作 📦
- get_pod - 获取特定 Pod 的详细信息
- list_pods - 列出命名空间中的 Pod
- get_pod_logs - 获取 Pod 日志
- get_deployment - 获取部署信息
- list_deployments - 列出命名空间中的部署
- scale_deployment - 扩展部署
- get_service - 获取服务信息
- list_services - 列出命名空间中的服务
- get_configmap - 获取 ConfigMap 信息
- list_configmaps - 列出命名空间中的 ConfigMap
- list_namespaces - 列出集群中的所有命名空间
- list_nodes - 列出集群中的所有节点
管理操作 ⚙️
- delete_pod - 从命名空间中删除 Pod
常见问题解答
- 默认情况下，服务器应用提供的 kubeconfig 或服务账户的权限
- 可以创建具有受限 RBAC 权限的专用服务账户
- 可以设置命名空间限制以防止跨命名空间操作
- 可以启用只读模式以防止对集群状态的更改
使用教程
使用依赖
- 具有 API 访问权限的 Kubernetes 集群
- 有效的 kubeconfig 文件或服务账户凭据
- 所需操作的适当 RBAC 权限
安装教程
与 Claude Desktop 一起使用
在 Claude Desktop 配置文件中添加以下内容：
json
{
"mcpServers": {
"kubernetes": {
"command": "path/to/k8smcp",
"args": [
"stdio",
"--kubeconfig=/path/to/your/kubeconfig"
],
"env": {
"KUBECONFIG": "/path/to/your/kubeconfig"
}
}
}
}
与 VS Code 一起使用
在 VS Code 用户设置文件中添加以下内容：
json
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "kubeconfig_path",
"description": "Path to kubeconfig file",
"default": "${env:HOME}/.kube/config"
}
],
"servers": {
"kubernetes": {
"command": "path/to/k8smcp",
"args": [
"stdio",
"--kubeconfig=/path/to/your/kubeconfig"
],
"env": {
"KUBECONFIG": "${input:kubeconfig_path}"
}
}
}
}
}
从源代码构建
bash
git clone https://github.com/briankscheong/k8s-mcp-server.git
cd k8s-mcp-server
make build
或直接使用 Go 安装：
bash
go install github.com/briankscheong/k8s-mcp-server/cmd/k8s-mcp-server@latest
调试方式
启动 stdio 服务器进行调试：
bash
k8smcp stdio --kubeconfig=/path/to/your/kubeconfig
