项目文档

标题

![Untitled]

项目介绍

这是一个名为“kubernetes-claude-mcp”的项目，旨在通过集成 Kubernetes、Argo CD 和 Anthropic 的 Claude 模型提供多租户容器平台的管理功能。

功能概述

• Kubernetes 资源管理：支持查看和操作 Kubernetes 资源。
• Argo CD 集成：与 Argo CD 应用交付工具集成，实现应用管理。
• Claude 模型集成：利用 Claude AI 模型进行资源分析和故障排除。

安装与配置

1. 克隆仓库

使用 Git 克隆项目：

git clone git@github.com:blankcut/kubernetes-claude-mcp.git

2. 安装依赖项

进入项目目录并安装 Go 依赖：

cd kubernetes-claude-mcp
go mod tidy

配置文件设置

配置文件路径为 kubernetes-claude-mcp/config.yaml，请根据实际情况修改以下内容：

Kubernetes 配置

• kubeconfig：指定 Kubernetes 配置文件的路径。
• inCluster：设置是否在集群内部运行。

Argo CD 配置

• url：Argo CD 服务的 URL 地址。
• authToken：Argo CD 的认证令牌。

GitLab 配置

• url：GitLab 服务的 URL 地址。
• apiVersion：使用的 GitLab API 版本。
• projectPath：项目的路径或 ID。

Claude 模型配置

• apiKey：Anthropic 提供的 API 密钥。
• baseURL：Claude 模型的服务地址。
• modelID：指定使用的模型版本。

本地运行

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

带日志调试

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

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 .

API 文档

基本接口

• 健康检查
  • 请求方式：GET /api/v1/health

Kubernetes 相关接口

• 获取命名空间
  • 请求方式：GET /api/v1/namespaces
• 列举资源
  • 请求方式：GET /api/v1/resources/{kind}?namespace={ns}
• 查询具体资源
  • 请求方式：GET /api/v1/resources/{kind}/{name}?namespace={ns}

Argo CD 相关接口

• 列出应用
  • 请求方式：GET /api/v1/argocd/applications

Claude MCP 特殊接口

• 资源分析
  • 请求方式：POST /api/v1/mcp/analyze
• 故障排除
  • 请求方式：POST /api/v1/mcp/debug

贡献指南

欢迎社区贡献！请参考项目仓库中的 CONTRIBUTING.md 文件了解如何参与。

许可证

项目遵循 MIT License 协议。

如有疑问，请联系项目维护者或查阅文档。