Claude Kubernetes MCP Server

Claude Kubernetes MCP Server

一个 Go 服务，可结合 Kubernetes API 的上下文以及可选的 ArgoCD 和 GitLab 信息，借助 Claude 回答有关 Kubernetes 集群的问题。

文档：docs.blankcut.com/kubernetes-mcp-server — 包含快速入门、安装说明、所有配置项和端点，以及故障排查。

功能

• 读取集群信息 — 命名空间、任意资源类型（包括自定义资源）、事件，以及按命名空间整理的资源、关系和健康状态映射。
• 无需 Claude 即可发现问题 — Warning 事件和失败的 CronJob（包含失败运行日志的末尾部分）会在数秒内整理成问题列表（?narrative=false）。
• 向 Claude 提问 — 可询问资源、整个命名空间或 GitLab 合并请求，并附上收集到的上下文。
• 监控自身的 ArgoCD 访问权限 — 每 60 秒检查一次令牌是否仍可读取 Applications，因此 RBAC 授权丢失时会显示错误，而不是空列表。
• 使用 API 密钥或 Workload Identity Federation 向 Claude 验证身份，因此无需长期有效的密钥也能运行。

它只读取信息：不会对 Kubernetes、ArgoCD 或 GitLab 做出任何更改。

它是一个 REST API。尽管名称如此，它并未实现 Model Context Protocol 的 JSON-RPC 传输，因此 Claude Desktop 等 MCP 客户端无法直接连接；请通过 HTTP 调用。

快速入门

从 Releases 下载发布版二进制文件（Linux 和 macOS，amd64 和 arm64），并编写 config.yaml：

server:
  address: ":8080"
  writeTimeout: 300
  auth:
    apiKey: "${API_KEY}"
kubernetes:
  inCluster: false          # uses $KUBECONFIG or ~/.kube/config
claude:
  apiKey: "${CLAUDE_API_KEY}"
  baseURL: "https://api.anthropic.com"
  modelID: "claude-sonnet-5"
  maxTokens: 8192

然后运行：

export API_KEY=$(openssl rand -hex 32) CLAUDE_API_KEY=sk-ant-...
./mcp-server-darwin-arm64 --config config.yaml

curl -s -H "X-API-Key: $API_KEY" \
  "http://localhost:8080/api/v1/namespaces/default/analysis?narrative=false"

快速入门将逐步介绍整个流程，包括校验和验证。

安装

方式
Helm	从发布标签的代码检出中运行 helm install kubernetes-mcp-server ./helm/kubernetes-mcp-server --set secrets.apiKey=... --set secrets.claudeApiKey=...。请参阅安装。
Docker	blankcut/kubernetes-mcp-server（linux/amd64、linux/arm64）；将配置挂载到 /app/config.yaml。
二进制文件	Releases，包含 checksums.txt。
源码	Go 1.26+：cd kubernetes-claude-mcp && go build -o mcp-server ./cmd/server。

开发

cd kubernetes-claude-mcp
go test ./...
go run ./cmd/server --config config.yaml --log-level debug

Postman 集合位于 postman/。变更记录列于 CHANGELOG.md；欢迎贡献，请参阅 CONTRIBUTING.md。

捐赠

请为我们的咖啡基金捐款，助力我们继续创造出色成果：请我喝咖啡

License

MIT