Troubleshoot MCP Server

🚀 Kubernetes 支持捆綁包 MCP 服務器

MCP（模型上下文協議）服務器是一款用於管理 Kubernetes 環境中支持捆綁包的工具。它具備豐富功能，涵蓋捆綁包管理、文件操作以及 kubectl 命令執行，能有效提升 Kubernetes 環境下的管理效率。

🚀 快速開始

安裝

# 克隆倉庫
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 命令。

📦 安裝指南

開發環境安裝

# 克隆倉庫
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]"

💻 使用示例

基礎用法

from mcp_server_troubleshoot import kubectl

# 執行 Kubectl 命令
result = kubectl.execute("get pods")
print(result)

📚 詳細文檔

• README.md：項目概述。
• docs/：詳細文檔，包括組件設計和示例提示。
• scripts/：構建和運行腳本。

🔧 技術細節

工具

• bundle.py：捆綁包管理模塊。
• files.py：文件操作模塊。
• kubectl.py：Kubectl 命令執行模塊。

項目結構

.
├── 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 服務器實現

代碼風格

# 使用 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 容器中，這是推薦的部署方法。

📄 許可證

本項目 licensed under Apache License 2.0 - 詳見LICENSE文件。

💡 使用建議

歡迎貢獻！請參考開發者指南瞭解如何貢獻。