K8s MCP Server G9i

🚀 K8s MCP Server 設定ガイド

K8s MCP Server は、Kubernetes の操作を簡素化するツールです。自然言語を使って Kubernetes クラスターの操作を行うことができ、kubectl コマンドの実行や Helm Chart のデプロイなど、様々な機能を提供します。

🚀 クイックスタート

以下のコマンドを使用して、K8s MCP Server を起動します。

docker run -i --rm ghcr.io/alexei-led/k8s-mcp-server:latest

MCP サーバーと自然言語で対話することができます。例えば、以下のようなフローで操作できます。

flowchart TB
    User->MCP_Server: "显示默认命名空间中的所有 pod"
    MCP_Server->K8s_API: kubectl get pods -n default
    K8s_API->MCP_Server: 返回 pod 列表
    MCP_Server->User: 显示结果并进行解释

✨ 主な機能

K8s MCP Server は、Kubernetes 操作を簡素化するためのツールで、以下の機能をサポートしています。

• kubectl コマンド実行：自然言語理解 (NLU) を通じてユーザーの意図を解析し、対応する kubectl コマンドを実行します。
• Helm Chart デプロイ：Helm チャートを自動的に解析し、デプロイコマンドを生成します。
• Istio サービスメッシュ管理：Istio サービスメッシュの設定と状態チェックをサポートします。
• ArgoCD アプリケーション管理：ArgoCD を統合して、アプリケーションのデリバリーとバージョン管理を行います。

💻 使用例

基本的な使用法

クラスター情報の照会

flowchart TB
    subgraph "Basic Commands"
        A1["显示默认命名空间中的所有 pod"]
        A2["获取所有命名空间中的服务"]
        A3["显示 nginx pod 的日志"]
    end

障害排除

flowchart TB
    subgraph "故障排查"
        B1["为什么我的部署没有启动？"]
        B2["描述失败的 pod 并解释错误原因"]
        B3["检查我的服务是否正确连接到 pod"]
    end

高度な使用法

ターゲットクラスターとネームスペースの指定

config.json に以下の設定を追加します。

{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/YOUR_USER_NAME/.kube:/home/appuser/.kube:ro",
        "-e", "K8S_CONTEXT=production-cluster",
        "-e", "K8S_NAMESPACE=my-application",
        "-e", "K8S_MCP_TIMEOUT=600",
        "ghcr.io/alexei-led/k8s-mcp-server:latest"
      ]
    }
  }
}

AWS EKS クラスターへの接続

{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/YOUR_USER_NAME/.kube:/home/appuser/.kube:ro",
        "-v", "/Users/YOUR_USER_NAME/.aws:/home/appuser/.aws:ro",
        "-e", "AWS_PROFILE=production",
        "-e", "AWS_REGION=us-west-2",
        "ghcr.io/alexei-led/k8s-mcp-server:latest"
      ]
    }
  }
}

Azure Kubernetes Service (AKS) への接続

{
  "mcpServers": {
    "kubernetes": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/YOUR_USER_NAME/.kube:/home/appuser/.kube:ro",
        "-e", "K8S_CONTEXT=aks-cluster",
        "ghcr.io/alexei-led/k8s-mcp-server:latest"
      ]
    }
  }
}

ログ記録の有効化

config.json に以下の内容を追加して、デバッグモードを有効にします。

{
  "logging": {
    "level": "debug",
    "file": "mcp_server.log"
  }
}

🔒 セキュリティに関する注意事項

• 認証：Kubernetes サービスアカウントまたは IAM ロールを使用して認証を行います。
• 承認：RBAC ポリシーを使用して、MCP Server のアクセス権限を制限します。
• ネットワーク分離：MCP Server を信頼できるネットワーク環境にデプロイします。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細な条項は以下の通りです。

版权所有 (c) 2023, Alexei Ledovskoi
Permission is granted to use, modify and distribute this software under the MIT License.

📞 連絡先

• GitHub：alexei-ledovskoi/k8s-mcp-server
• メール：support@k8s-mcp-server.com
• コミュニティフォーラム：Discussions