Kubernetes Claude

🚀 kubernetes - claude - mcp

この「kubernetes - claude - mcp」プロジェクトは、Kubernetes、Argo CD、およびAnthropicのClaudeモデルを統合することで、マルチテナントコンテナプラットフォームの管理機能を提供することを目的としています。

🚀 クイックスタート

このプロジェクトを使用するには、まず以下の手順でインストールと設定を行います。

✨ 主な機能

• Kubernetesリソース管理：Kubernetesリソースの表示と操作をサポートします。
• Argo CD統合：Argo CDアプリケーション配布ツールと統合し、アプリケーション管理を実現します。
• Claudeモデル統合：Claude AIモデルを利用して、リソース分析と障害排除を行います。

📦 インストール

1. リポジトリのクローン

Gitを使用してプロジェクトをクローンします。

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

2. 依存関係のインストール

プロジェクトディレクトリに移動し、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でのデプロイ

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

本番環境でのデプロイ

プロジェクトはHelmチャートを提供しており、Kubernetesにデプロイできます。

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

cd kubernetes-claude-mcp/deployments/helm

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

🤝 貢献ガイド

コミュニティからの貢献を歓迎します！プロジェクトリポジトリの CONTRIBUTING.md ファイルを参照して、参加方法を確認してください。

📄 ライセンス

このプロジェクトは MIT License の下で公開されています。

ご質問がある場合は、プロジェクトのメンテナにお問い合わせいただくか、ドキュメントをご参照ください。