Troubleshoot MCP Server

🚀 Kubernetes サポートバンドル MCP サーバー

MCP（モデルコンテキストプロトコル）サーバーは、Kubernetes 環境におけるサポートバンドルを管理するためのツールです。バンドル管理、ファイル操作、kubectl コマンドの実行など、豊富な機能を提供します。

🚀 クイックスタート

インストール

# リポジトリをクローン
git clone https://github.com/your-username/mcp-server-troubleshoot.git
cd mcp-server-troubleshoot

# 仮想環境を作成
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 依存関係をインストール
pip install -r requirements.txt

実行

# サーバーを起動
python src/mcp_server_troubleshoot/__main__.py

✨ 主な機能

• バンドル管理：サポートバンドルの作成、更新、削除をサポートします。
• ファイル操作：バンドル内容の読み取りと書き込み機能を提供します。
• Kubectl コマンド実行：サーバー上で直接 kubectl コマンドを実行できます。

📚 ドキュメント

• README.md：プロジェクトの概要です。
• docs/：コンポーネント設計やサンプルヒントなどの詳細なドキュメントが含まれています。
• scripts/：ビルドと実行用のスクリプトがあります。

🔧 ツール

• bundle.py：バンドル管理モジュールです。
• files.py：ファイル操作モジュールです。
• kubectl.py：Kubectl コマンド実行モジュールです。

💻 使用例

基本的な使用法

from mcp_server_troubleshoot import kubectl

# Kubectl コマンドを実行
result = kubectl.execute("get pods")
print(result)

📁 プロジェクト構造

.
├── README.md                # プロジェクトの概要
├── docs/                   # ドキュメント
│   ├── agentic/            # AI エージェントのドキュメント
│   ├── components/         # コンポーネント設計のドキュメント
│   └── examples/           # サンプルヒントと使用例
└── src/                    # ソースコード
    └── mcp_server_troubleshoot/
        ├── __init__.py
        ├── __main__.py     # エントリーポイント
        ├── bundle.py       # バンドル管理
        ├── cli.py          # CLI インターフェース
        ├── config.py       # 設定管理
        ├── files.py        # ファイル操作
        ├── kubectl.py      # Kubectl コマンド実行
        └── server.py       # MCP サーバーの実装

👨‍💻 開発

インストール

# リポジトリをクローン
git clone https://github.com/your-username/mcp-server-troubleshoot.git
cd mcp-server-troubleshoot

# 仮想環境を作成
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 開発用の依存関係をインストール
pip install -e ".[dev]"

コードスタイル

# Black を使用してコードをフォーマット
black .

# Ruff を使用してコード規約をチェック
ruff check .

テスト

# すべてのテストを実行
pytest

# 詳細な出力でテストを実行
pytest -v

# 特定のタイプのテストを実行
pytest -m unit
pytest -m integration
pytest -m e2e

# 詳細な警告モードでテストを実行
pytest -W all

# 警告をエラーとしてテストを実行
pytest -W error

📋 要件

• Python 3.13
• kubectl コマンドラインツール
• バンドル管理用の sbctl コマンドラインツール
• 認証トークン（環境変数：SBCTL_TOKEN または REPLICATED）

すべての依存関係は Podman コンテナに含まれており、これが推奨のデプロイ方法です。

🤝 コントリビューション

コントリビューションを歓迎します！開発者ガイドを参照して、コントリビュートする方法を確認してください。

📄 ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています - 詳細はLICENSEファイルを参照してください。