Claude Kubernetes MCP Server

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

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

評分 : 2.5分

下載量 : 9.4K

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