Claude Kubernetes MCP Server

基本能力

产品定位

Claude Kubernetes MCP Server 是一个用于 Kubernetes 环境的高级控制和自动化工具，集成了 ArgoCD、GitLab 和 Claude AI，提供 REST API 以程序化方式与这些系统交互。

核心功能

1. Kubernetes 集成：支持列出命名空间、资源、获取特定资源和事件。
2. ArgoCD 集成：支持列出应用程序。
3. Claude AI 集成：支持分析资源、故障排除、提交分析和通用 MCP 请求。
4. GitLab 集成：支持提交分析到 GitLab。
5. Vault 集成（可选）：支持使用 Vault 进行凭证管理。

适用场景

1. Kubernetes 环境自动化：自动化管理 Kubernetes 资源。
2. CI/CD 流程集成：与 ArgoCD 和 GitLab 集成，实现自动化部署和更新。
3. AI 驱动的分析和故障排除：使用 Claude AI 进行资源分析和故障排除。

工具列表

1. Kubernetes CLI：用于与 Kubernetes 集群交互。
2. ArgoCD CLI：用于与 ArgoCD 交互。
3. GitLab API：用于与 GitLab 交互。
4. Claude API：用于与 Claude AI 交互。
5. Vault CLI（可选）：用于与 Vault 交互。

常见问题解答

1. 如何配置服务器：通过 config.yaml 文件配置服务器参数和凭证。
2. 如何运行服务器：可以使用 Go 直接运行或使用 Docker 容器运行。
3. 如何部署到生产环境：使用 Helm 图表进行 Kubernetes 部署。

使用教程

使用依赖

1. 安装 Go 1.20+： bash sudo apt-get install golang
2. 安装 Docker： bash sudo apt-get install docker.io
3. 配置 Kubernetes 集群：确保 ~/.kube/config 文件有效。
4. 获取 ArgoCD、GitLab 和 Claude API 凭证：确保这些凭证已准备好并可以导出为环境变量。

安装教程

1. 克隆仓库： bash git clone https://github.com/blankcut/kubernetes-mcp-server.git cd kubernetes-mcp-server
2. 导出环境变量： bash export ARGOCD_USERNAME="argocd-username" export ARGOCD_PASSWORD="argocd-password" export GITLAB_TOKEN="gitlab-token" export CLAUDE_API_KEY="claude-api-key" export VAULT_TOKEN="optional-if-using-vault" export KUBECONFIG=~/.kube/config
3. 配置 config.yaml：更新 kubernetes-claude-mcp/config.yaml 文件。

调试方式

1. 本地运行： bash cd kubernetes-claude-mcp go run ./cmd/server/main.go
2. 带调试日志运行： bash LOG_LEVEL=debug go run ./cmd/server/main.go --config config.yaml
3. 使用 Docker 运行： bash cd kubernetes-claude-mcp docker build -t claude-mcp-server -f Dockerfile . docker-compose build docker-compose up -d
4. 生产部署： bash cd kubernetes-claude-mcp/deployments/helm helm install claude-mcp .

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。