Kubectl MCP Server

🚀 Kubectl MCP ツール使用ガイド

このプロジェクトは、Kubernetes クラスタとのインタラクションに使用する kubectl - mcp というツールを提供します。このツールは、診断、コア操作、セキュリティ監視、自然言語処理など、さまざまな機能モジュールをサポートしています。

🚀 クイックスタート

コア機能モジュール

• 診断モジュール：Kubernetes クラスタの健全性チェックと障害トラブルシューティングを実行します。
• コア操作モジュール：get pods、describe nodes などの基本的な kubectl コマンドを提供します。
• セキュリティモジュール：認証、承認、暗号化などの機能を含む、クラスタのセキュリティを強化します。
• 監視モジュール：監視ツールを統合し、Kubernetes リソースの状態をリアルタイムで追跡します。

自然言語処理

自然言語入力による Kubernetes 操作の実行をサポートします。例えば：

kubectl mcp "表示所有运行中的pod"

✨ 主な機能

• 複数の機能モジュールをサポートし、Kubernetes クラスタの管理を容易にします。
• 自然言語入力による操作を可能にし、使いやすさを向上させます。
• 自動構成と Helm サポートなどの高度な機能を備えています。

📦 インストール

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

git clone https://github.com/rohitg00/kubectl-mcp-server.git
cd kubectl-mcp-server

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

pip install -r requirements.txt

3. 開発モードでのインストール

pip install -e .

💻 使用例

基本的な使用法

ポッドの一覧表示

列出默认命名空间中所有正在运行的pod。

アプリケーションのデプロイ

创建一个名为 `nginx - test` 的部署，使用 `nginx:latest` 镜像，并设置 3 个副本。

ログの表示

获取名为 `nginx - test` 的pod的日志输出。

ポートフォワーディング

将本地的8080端口转发到pod的80端口。

高度な使用法

自動構成

すべてのサポートされる AI アシスタントの構成を自動的に完了するには、インストールスクリプトを実行します。

bash install.sh

統合ガイド

• Helm サポート：Helm v3 を通じて Kubernetes アプリケーションを管理します。
• ログ分析：ログ収集ツールを統合し、問題のトラブルシューティングを容易にします。

📚 ドキュメント

プロジェクト構造

├── kubectl_mcp_tool/         # 主程序包
│   ├── __init__.py           # 包初始化文件
│   ├── cli.py                # CLI 入口点
│   ├── mcp_server.py         # MCP 服务器实现
│   ├── mcp_kubectl_tool.py   # 主 kubectl MCP 工具实现
│   ├── natural_language.py   # 自然语言处理模块
│   ├── diagnostics.py        # 诊断功能模块
│   ├── core/                 # 核心功能模块 
│   ├── security/             # 安全操作模块
│   ├── monitoring/           # 监控功能模块
│   ├── utils/                # 工具函数包
│   └── cli/                  # CLI 功能组件
├── python_tests/             # 测试套件
│   ├── run_mcp_tests.py      # 测试运行器脚本
│   ├── mcp_client_simulator.py # MCP 客户端模拟器用于 mock 测试
│   ├── test_utils.py         # 测试工具包
│   ├── test_mcp_core.py      # 核心 MCP 测试
│   ├── test_mcp_security.py  # 安全性测试
│   ├── test_mcp_monitoring.py # 监控测试
│   ├── test_mcp_natural_language.py # 自然语言处理测试
│   └── test_mcp_diagnostics.py # 诊断功能测试
├── config/                   # 配置文件和示例
│   ├── kubectl-mcp-config.yaml # MCP 工具配置文件模板
│   └── example_usage.md       # 示例使用文档
└── scripts/                  # 脚本工具
    ├── install.sh            # 安装脚本
    └── setup_helm.sh         # Helm 集成脚本

プロジェクト依存関係

• Python バージョン：3.8+
• Kubernetes バージョン：1.20+

🔧 技術詳細

このツールは、Python を使用して開発されており、Kubernetes API を介してクラスタと通信します。自然言語処理機能は、特定の NLP ライブラリを使用して実装されています。

📄 ライセンス

MIT License

コンタクト

• メール：support@kubectl - mcp.org
• GitHub：https://github.com/rohitg00/kubectl-mcp-server

貢献ガイド

コミュニティからの貢献を歓迎します！開発への参加方法については、CONTRIBUTING.md を参照してください。