MCP Server Dynamic Env

🚀 動態環境 MCP 服務器

動態環境 MCP 服務器是一個高性能的 Kubernetes MCP 服務器，用於管理 DynamicEnv 自定義資源。它支持即時更新和 AI 驅動集成，能幫助開發者和 AI 代理安全高效地管理基於 K8s 的環境。

✨ 概述

動態環境 MCP 服務器 在 DynamicEnv Kubernetes 自定義資源上提供了面向 AI 的友好 API 接口，可實現對動態環境的即時跟蹤、智能調試以及簡化清理操作。該服務器適用於開發、測試及短期工作負載。

此服務器採用異步優先架構設計，並與模型上下文協議（MCP）無縫集成，能賦能開發者和 AI 代理安全高效地管理基於 K8s 的環境。

🔍 什麼是 DynamicEnv？

DynamicEnv 是 Kubernetes 自定義資源 (CRD)，它封裝了完整的動態環境配置，通常包括以下內容：

• 多個相互依賴的服務
• 服務特定配置（密鑰、配置文件、環境變量）
• 路由規則（Ingress、服務網格）
• 資源限制（CPU、內存配額）

該服務器增強了對這些資源的可觀測性和控制能力。

🚀 為何選擇 MCP？

模型上下文協議 (MCP) 允許 AI 工具實現以下功能：

• 訂閱即時更新
• 管理長期異步操作並跟蹤進度
• 通過驗證和結構化上下文安全運行
• 提升 DevOps 工作流程中的智能命令建議

📄 核心功能

• ✅ 列表與篩選：可按命名空間、狀態或部署狀態過濾 DynamicEnv 實例。
• ⏳ 即時狀態監控：支持異步更新和進度報告。
• ❌ 安全刪除：帶有依賴檢查的環境清理。
• ⚖️ K8s 安全認證：使用集群內或 kubeconfig 憑證。
• 🔍 Pod 洞察、部署健康狀況及可選日誌。
• ✨ AI 友好型 接口通過 MCP。

🗓 快速開始

克隆倉庫

git clone https://github.com/yonathan-shtekel/mcp-server-dynamic-env.git
cd mcp-server-dynamic-env

創建虛擬環境

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

安裝依賴項

uv pip install -e .

📖 使用方法

本地開發

# 安裝 MCP 工具
mcp tool install

# 啟動 MCP 服務
mcp server start

示例命令

# 創建 DynamicEnv 實例
mcp dynamicenv create --name my-env --spec '{"containers": [{"name": "web", "image": "nginx:latest"}]}'

# 獲取實例狀態
mcp dynamicenv get my-env

項目結構

.
├── README.md          # 項目文檔
├── pyproject.toml    # 項目配置
├── src/
│   ├── server.py     # MCP 服務器主程序
│   └── handlers/
│       └── dynamicenv.py  # DynamicEnv 資源處理邏輯
└── tests/
    └── test_server.py  # 服務器功能測試用例

開發規範

靜態代碼分析

# 類型檢查
mypy src tests

# 安全掃描
bandit -r src
safety check

# 文檔覆蓋率
interrogate src

所有這些檢查都會在 CI/CD 管道中自動執行。

其他工具

• 日誌記錄：使用 logging 模塊實現結構化日誌。
• 配置管理：通過 pyproject.toml 統一管理項目設置。
• 測試框架：基於 pytest 的單元測試框架。

歡迎貢獻代碼！如需幫助，請參考 CONTRIBUTING.md。