claude-kubernetes-mcp-server

🚀 项目文档

本项目主要用于搭建一个集成了Kubernetes、Argo CD、GitLab和Claude等服务的系统，通过配置文件对各服务进行参数设置，提供了多种运行和部署方式，同时定义了丰富的API接口，方便用户进行资源管理和分析等操作。

🚀 快速开始

快速运行

在项目根目录下，可使用以下命令快速启动服务：

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. 构建镜像

在项目根目录下执行以下命令构建 Docker 镜像：

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

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

同样在项目根目录下，使用 Docker Compose 构建并启动容器：

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 .

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

📦 服务地址

服务的配置信息存储在 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

💻 使用示例

本项目主要通过 API 接口与服务进行交互，以下是部分 API 接口的使用示例。

基本

健康检查

curl -H "X-API-Key: your_api_key" http://localhost:8080/api/v1/health

Kubernetes

列出命名空间

curl -H "X-API-Key: your_api_key" http://localhost:8080/api/v1/namespaces

列出资源

curl -H "X-API-Key: your_api_key" "http://localhost:8080/api/v1/resources/pods?namespace=default"

Argo CD

列出应用

curl -H "X-API-Key: your_api_key" http://localhost:8080/api/v1/argocd/applications

Claude MCP 端点

分析资源

curl -X POST -H "X-API-Key: your_api_key" -H "Content-Type: application/json" -d '{"data": "your_data"}' http://localhost:8080/api/v1/mcp/resource

📚 详细文档

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 文件中的许可协议。

感谢您的支持！