Kubernetes Claude

🚀 kubernetes - claude - mcp項目

這是一個名為“kubernetes - claude - mcp”的項目，旨在通過集成 Kubernetes、Argo CD 和 Anthropic 的 Claude 模型，為多租戶容器平臺提供管理功能。

🚀 快速開始

本項目通過集成 Kubernetes、Argo CD 和 Anthropic 的 Claude 模型，提供多租戶容器平臺的管理功能。以下是快速開始的步驟：

1. 克隆倉庫

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

2. 安裝依賴項

cd kubernetes-claude-mcp
go mod tidy

3. 配置文件設置：根據實際情況修改 kubernetes-claude-mcp/config.yaml 文件。
4. 本地運行

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

✨ 主要特性

• Kubernetes 資源管理：支持查看和操作 Kubernetes 資源。
• Argo CD 集成：與 Argo CD 應用交付工具集成，實現應用管理。
• Claude 模型集成：利用 Claude AI 模型進行資源分析和故障排除。

📦 安裝指南

克隆倉庫

使用 Git 克隆項目：

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

安裝依賴項

進入項目目錄並安裝 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 部署

構建鏡像

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 .

💻 使用示例

基礎用法

在本地運行項目：

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

高級用法

帶日誌調試運行：

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

📚 詳細文檔

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

📄 許可證

項目遵循 MIT License 協議。

貢獻指南

歡迎社區貢獻！請參考項目倉庫中的 CONTRIBUTING.md 文件瞭解如何參與。

如有疑問，請聯繫項目維護者或查閱文檔。