Claude Kubernetes MCP Server

🚀 クラウドネイティブMCPサーバー

このプロジェクトは、Kubernetes、Argo CD、GitLab、Claudeを統合したサービスを提供します。サーバーの設定や起動方法、APIの使用方法などを提供しています。

🚀 クイックスタート

サービスアドレス

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を使用したビルドと実行

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

本番環境へのデプロイ

このプロジェクトには、Kubernetesへのデプロイ用のHelmチャートが含まれています。

1. Helmチャートディレクトリに移動

cd kubernetes-claude-mcp/deployments/helm

2. 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

問題の提出

Issues を通じて問題を提出してください。

👥 コントリビューター

• [あなたの名前] - プロジェクトメンテナ
• その他のコントリビューター - （オプション）

📄 ライセンス

LICENSE

ありがとうございます！