Kopilot MCP

Kopilot MCP

MCP のリメイク 🔧 版です。以前のプロジェクトをベースにしています。

主な機能

• MCP を使用して AI Kubernetes エージェントを作成します。
• 自然言語を使用して Kubernetes リソースと対話します。
• LLM プロバイダーをカスタマイズして「kubectl のような」コマンドを実行します。
• MCP を使用してツール呼び出しを標準化する方法を学習します。

技術スタック

• Dynaconf
• kubernetes
• LangChain
• Loguru
• OpenAI

はじめに

前提条件

• Python 3.12 以上
• uv
• LLM プロバイダーの API キー（例：OpenRouter）
• Kubernetes クラスター（例：kind）

セットアップ

1. このリポジトリをクローンします。
2. config/dev/example.toml を設定して、config/dev/config.toml にリネームします。
3. 依存関係をインストールします。

uv sync

実行

1. MCP クライアントを実行します。MCP サーバーが自動的に起動します。

uv run mcp_client.py

2. ターミナルにプロンプトが表示されます：

Query (Type `exit`, `quit`, `q` to quit):

3. 自然言語を使用して Kubernetes リソースを操作できます。例えば：

Query (Type `exit`, `quit`, `q` to quit): Get po in kube-system ns

4. 次のような応答が得られます：

Here are the pods in the `kube-system` namespace:

- coredns-7db6d8ff4d-lz4s8
- coredns-7db6d8ff4d-qbgvc
- etcd-test-control-plane
- kindnet-cnjm6
- kube-apiserver-test-control-plane
- kube-controller-manager-test-control-plane
- kube-proxy-v647r
- kube-scheduler-test-control-plane
- sealed-secrets-controller-67767c668-dz4bj

プロジェクト構造

kopilot-mcp
├── README.md             # Project documentation
├── config                # Configuration
│   ├── config.py
│   └── dev
│       └── example.toml
├── mcp_client.py         # MCP client
├── mcp_server.py         # MCP server
├── mcp_server_factory.py # MCP server factory
├── pyproject.toml        # Python project meta
├── scheme                # scheme (Kubernetes GVR ➡ GVK)
│   ├── __init__.py
│   └── scheme.py
├── utils                 # Utilities
│   ├── __init__.py
│   ├── clients.py
│   ├── helpers.py
│   └── models.py
└── uv.lock               # uv lock file

ワークフロー

貢献

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. プルリクエストを送信します。

ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。