Kdebug (Kubernetes)

🚀 KDebug - Kubernetes デバッグ MCP サーバ

KDebug は、Claude AI を通じて Kubernetes クラスターと対話できる Kubernetes デバッグツールです。このツールは、モデル制御プロトコル (MCP) を使用して、Claude が Kubernetes コマンドを実行する機能を実現します。

🚀 クイックスタート

概要

このツールを使用すると、以下の操作が可能です。

• Kubernetes リソース（ポッド、サービス、デプロイなど）を確認する
• ポッドのログを表示する
• ノードの状態を確認する
• イベントを監視する
• その他、対話型 AI を通じて様々な操作を行うことができます。

📦 インストール

前提条件

• Go 1.18 以上（ソースコードからビルドする場合）
• 設定済みの Kubernetes クラスターへのアクセス (~/.kube/config)
• MCP をサポートする Claude クライアント

オプション 1：事前構築済みのバイナリをダウンロードする

1. GitHub のリリースページにアクセスします。

https://github.com/soub4i/kdebug-mcp/releases

2. お使いのオペレーティングシステム（macOS、Linux、Windows）に対応する最新バージョンをダウンロードします。
3. バイナリファイルを実行可能に設定します。

chmod +x kdebug-mcp

4. バイナリファイルを PATH の中にある場所に移動します。

mv kdebug-mcp /usr/local/bin/kdebug-mcp
# または
mv kdebug-mcp ~/bin/kdebug-mcp  # ~/bin を PATH 環境変数に追加している場合

オプション 2：ソースコードからビルドする

1. リポジトリをクローンします。

git clone https://github.com/soub4i/kdebug-mcp.git
cd kdebug-mcp

2. バイナリファイルをビルドします。

go build -o bin/server ./cmd/server/main.go

📚 ドキュメント

設定

KDebug を使用するように Claude を設定する

以下の場所にある Claude MCP 設定ファイルを作成または編集します。

• macOS: ~/Library/Application Support/com.anthropic.claude/config.json
• Linux: ~/.config/com.anthropic.claude/config.json
• Windows: %APPDATA%\com.anthropic.claude\config.json

以下の設定を追加します。

{
    "mcpServers": {
        "kdebug": {
            "command": "/path/to/kdebug-mcp/bin/server"
        }
    }
}

/path/to/kdebug-mcp/bin/server を実際の KDebug バイナリファイルのパスに置き換えてください。

Kubernetes コンテキスト

KDebug は、~/.kube/config から現在の Kubernetes コンテキストを使用します。Kubernetes の設定が正しく行われていることを確認してください。 コンテキストを切り替えるには、以下のコマンドを使用します。

kubectl config use-context <context-name>

使用方法

1. Claude を起動し、KDebug MCP サーバに接続していることを確認します。
2. Claude との対話で、Kubernetes リソースに関する質問をします。

例：

• "クラスターに何か問題はありますか？コンテキスト: minikube。ネームスペース: default"
• "すべてのノードをリストアップしてください。"
• "ポッドのリストを表示してください。"

トラブルシューティング

Kubernetes クラスターに接続できない場合

以下の点を確認してください。

1. ~/.kube/config ファイルが存在し、正しく設定されていることを確認します。
2. kubectl config view --output=yaml コマンドを使用して、コンテキストが正しい環境に設定されていることを確認します。
3. Minikube を使用している場合は、minikube status を実行して状態を確認します。

KDebug サービスを起動できない場合

1. KDebug 実行可能ファイルが正しくビルドされていることを確認します。
2. ターミナルで KDebug サービスを実行し、出力を確認して詳細な情報を取得します。

./bin/server

セキュリティに関する注意事項

• 適切なセキュリティ対策がない限り、本番環境で KDebug サービスを公開しないでください。
• ~/.kube/config ファイルがあなたと root ユーザーのみが読み取り可能な状態になっていることを確認し、不正アクセスを防止してください。

KDebug は、Claude AI の力を借りて、Kubernetes のデバッグプロセスを簡素化する強力なツールです。これにより、クラスター管理がより効率的かつ便利になります。