Claude Kubernetes MCP Server

Claude Kubernetes MCP服務器是一個基於Go的集成平臺，結合ArgoCD、GitLab和Claude AI實現Kubernetes環境的高級控制和自動化。

開發者工具雲平臺 #Kubernetes #AI運維 #持續部署 #自動化 .Go

評分 : 2.5分

下載量 : 22

更新時間 : 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