项目文档

![未命名]

服务地址

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 构建与运行

1. 构建镜像

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

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

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

生产部署

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

1. 切换到 Helm 图表目录

cd kubernetes-claude-mcp/deployments/helm

2. 使用 Helm 部署

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

helm install claude-mcp .

要升级：

helm upgrade claude-mcp .

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

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

提交问题

请通过 Issues 提交问题。

贡献者

• [你的名字] - 项目维护者
• 其他贡献者 - （可选）

许可证

LICENSE

感谢您的支持！