Claude Kubernetes MCP Server

Claude Kubernetes MCP服务器是一个基于Go的集成平台，结合ArgoCD、GitLab和Claude AI实现Kubernetes环境的高级控制和自动化。

开发者工具云平台 #Kubernetes #AI运维 #持续部署 #自动化 .Go

评分 : 2.5分

下载量 : 32

更新时间 : 2025-04-23

什么是Claude Kubernetes MCP Server?

Claude Kubernetes MCP Server是一个智能化的Kubernetes管理平台，通过整合Claude AI的能力，为您的Kubernetes集群提供AI驱动的自动化运维、智能分析和故障诊断功能。它可以与ArgoCD和GitLab无缝集成，实现从代码提交到部署的全流程智能化管理。

如何使用Claude Kubernetes MCP Server?

使用本服务非常简单：1) 配置好您的Kubernetes集群访问权限 2) 设置ArgoCD和GitLab的集成 3) 通过REST API或Web界面与AI交互。服务器会自动分析您的集群状态并提供智能建议。

适用场景

特别适合需要自动化管理多个Kubernetes集群的团队，或希望利用AI能力简化Kubernetes运维复杂性的组织。典型场景包括：智能部署审核、异常自动诊断、资源配置优化建议等。

主要功能

AI智能诊断通过Claude AI自动分析Kubernetes资源异常，提供自然语言解释和修复建议

GitOps集成与ArgoCD深度集成，实现从代码变更到部署的自动化流水线

多集群管理统一管理多个Kubernetes集群的资源和工作负载

安全分析自动检测资源配置中的安全隐患并提供优化建议

优势与局限性

优势

AI驱动的智能运维，大幅降低Kubernetes学习曲线

无缝集成现有GitOps工具链(ArgoCD/GitLab)

通过自然语言交互简化复杂运维操作

提供主动式异常检测和预防建议

局限性

需要Claude API访问权限

对网络连接稳定性要求较高

AI分析结果可能需要人工验证

初始配置需要一定Kubernetes基础知识

如何使用

准备环境

确保已安装Docker和kubectl，并配置好Kubernetes集群访问权限

获取API密钥

申请Claude API密钥和GitLab访问令牌

配置服务器

编辑config.yaml文件，设置集群信息和集成参数

启动服务

使用Docker或直接运行方式启动MCP服务器

开始使用

通过API或Web界面与服务器交互，发送您的第一个AI请求

使用案例

诊断Pod启动失败当某个Pod持续处于CrashLoopBackOff状态时，通过AI分析日志和事件找出根本原因

自动生成资源配置通过自然语言描述生成符合最佳实践的Kubernetes部署清单

安全策略审核检查命名空间中的安全配置是否符合公司策略

常见问题

是否需要付费Claude API订阅?

支持哪些Kubernetes版本?

如何确保API通信安全?

AI分析的准确性如何?

🚀 项目文档

本项目是一个集成了Kubernetes、Argo CD、GitLab和Claude的服务，可用于对Kubernetes资源进行分析、故障排除等操作，为Kubernetes集群管理提供便利。

🚀 快速开始

服务地址配置

在 kubernetes-claude-mcp/config.yaml 文件中进行服务的相关配置，以下是配置示例：

server:
  address: ":8080"
  readTimeout: 30
  writeTimeout: 60
  auth:
    apiKey: ""${API_KEY}"" 

kubernetes:
  kubeconfig: ""
  inCluster: false
  defaultContext: ""
  defaultNamespace: "default"

argocd:
  url: "http://example.argocd.com"
  authToken: ""
  username: "${ARGOCD_USERNAME}"
  password: "${ARGOCD_PASSWORD}"
  insecure: true

gitlab:
  url: "https://gitlab.com"
  authToken: "${AUTH_TOKEN}"
  apiVersion: "v4"
  projectPath: ""${PROJECT_PATH}""

claude:
  apiKey: "${API_KEY}"
  baseURL: "https://api.anthropic.com"
  modelID: "claude-3-haiku-20240307"
  maxTokens: 4096
  temperature: 0.7

快速运行

普通运行

进入项目目录并运行服务：

cd kubernetes-claude-mcp
go run ./cmd/server/main.go

带调试日志运行

LOG_LEVEL=debug go run ./cmd/server/main.go --config config.yaml

服务将启动并绑定到 config.yaml 中配置的地址（默认：8080）。

使用 Docker 构建与运行

构建镜像

cd kubernetes-claude-mcp
docker build -t claude-mcp-server -f Dockerfile .

运行容器（第二套构建选项）

cd kubernetes-claude-mcp
docker-compose build
docker-compose up -d

生产部署

项目包含一个 Helm 图表用于 Kubernetes 部署：

切换到 Helm 图表目录

cd kubernetes-claude-mcp/deployments/helm

使用 Helm 部署

更新 values.yaml 中的值并运行：

helm install claude-mcp .

要升级：

helm upgrade claude-mcp .

请确保在集群中正确挂载和安全配置密钥和配置映射。

💻 使用示例

基本用法

以下是启动服务的基本命令示例：

cd kubernetes-claude-mcp
go run ./cmd/server/main.go

高级用法

带调试日志启动服务：

LOG_LEVEL=debug go run ./cmd/server/main.go --config config.yaml

📚 详细文档

API 文档

以下是 MCP 服务器暴露的主要端点。所有请求均需要 X-API-Key 标头：

基本

健康检查
- GET /api/v1/health

Kubernetes

列出命名空间
- GET /api/v1/namespaces
列出资源
- GET /api/v1/resources/{kind}?namespace={ns}
获取特定资源
- GET /api/v1/resources/{kind}/{name}?namespace={ns}
获取资源事件
- GET /api/v1/events?namespace={ns}&resource={kind}&name={name}

Argo CD

列出应用
- GET /api/v1/argocd/applications

Claude MCP 端点

分析资源
- POST /api/v1/mcp/resource
故障排除资源
- POST /api/v1/mcp/troubleshoot
提交分析（GitLab）
- POST /api/v1/mcp/commit
获取提交状态
- GET /api/v1/mcp/commits/{cluster}

🤝 贡献指南

提交代码

git clone https://github.com/yourusername/kubernetes-claude-mcp.git
cd kubernetes-claude-mcp
# 修改代码
git add .
git commit -m "提交信息"
git push origin main