基本能力
产品定位
Claude Kubernetes MCP Server 是一个用于 Kubernetes 环境的高级控制和自动化工具,集成了 ArgoCD、GitLab 和 Claude AI,提供 REST API 以程序化方式与这些系统交互。
核心功能
- Kubernetes 集成:支持列出命名空间、资源、获取特定资源和事件。
- ArgoCD 集成:支持列出应用程序。
- Claude AI 集成:支持分析资源、故障排除、提交分析和通用 MCP 请求。
- GitLab 集成:支持提交分析到 GitLab。
- Vault 集成(可选):支持使用 Vault 进行凭证管理。
适用场景
- Kubernetes 环境自动化:自动化管理 Kubernetes 资源。
- CI/CD 流程集成:与 ArgoCD 和 GitLab 集成,实现自动化部署和更新。
- AI 驱动的分析和故障排除:使用 Claude AI 进行资源分析和故障排除。
工具列表
- Kubernetes CLI:用于与 Kubernetes 集群交互。
- ArgoCD CLI:用于与 ArgoCD 交互。
- GitLab API:用于与 GitLab 交互。
- Claude API:用于与 Claude AI 交互。
- Vault CLI(可选):用于与 Vault 交互。
常见问题解答
- 如何配置服务器:通过
config.yaml
文件配置服务器参数和凭证。 - 如何运行服务器:可以使用 Go 直接运行或使用 Docker 容器运行。
- 如何部署到生产环境:使用 Helm 图表进行 Kubernetes 部署。
使用教程
使用依赖
- 安装 Go 1.20+:
bash
sudo apt-get install golang - 安装 Docker:
bash
sudo apt-get install docker.io - 配置 Kubernetes 集群:确保
~/.kube/config
文件有效。 - 获取 ArgoCD、GitLab 和 Claude API 凭证:确保这些凭证已准备好并可以导出为环境变量。
安装教程
- 克隆仓库:
bash
git clone https://github.com/blankcut/kubernetes-mcp-server.git
cd kubernetes-mcp-server - 导出环境变量:
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 - 配置
config.yaml
:更新kubernetes-claude-mcp/config.yaml
文件。
调试方式
- 本地运行:
bash
cd kubernetes-claude-mcp
go run ./cmd/server/main.go - 带调试日志运行:
bash
LOG_LEVEL=debug go run ./cmd/server/main.go --config config.yaml - 使用 Docker 运行:
bash
cd kubernetes-claude-mcp
docker build -t claude-mcp-server -f Dockerfile .
docker-compose build
docker-compose up -d - 生产部署:
bash
cd kubernetes-claude-mcp/deployments/helm
helm install claude-mcp .