MCP Kubernetes Server

基本能力

产品定位

MCP Kubernetes Server 是一个 Kubernetes 管理工具，旨在通过 MCP 协议提供对 Kubernetes 集群的全面管理和监控能力。

核心功能

• 集群信息获取：获取 Kubernetes 资源（如 pods、deployments、services 等）的详细信息。
• 集群操作：对 Kubernetes 资源执行创建、更新、删除、扩展等操作。
• 监控：监控 Kubernetes 集群和资源的状态。
• 分析：分析 Kubernetes 资源并提供建议。
• 提示：包含常见 Kubernetes 分析任务的提示。

适用场景

• Kubernetes 集群的日常管理和维护。
• 自动化部署和扩展 Kubernetes 资源。
• 集群健康状态监控和故障排查。
• 资源使用情况分析和优化建议。

工具列表

• 资源信息工具：get_resources, get_resource, get_resource_status, get_resource_events, get_resource_logs。
• 资源操作工具：create_resource, update_resource, delete_resource, scale_deployment, restart_deployment, execute_command。
• 监控工具：get_cluster_status, get_node_status, get_resource_metrics, get_cluster_metrics, check_cluster_health。

常见问题解答

• 如何配置服务器：可以通过 YAML 配置文件、环境变量或命令行参数进行配置。
• 如何在集群外测试：可以手动设置环境变量和创建必要的文件来模拟集群内配置。

使用教程

使用依赖

• 确保已安装 Python 和 pip。
• 确保已安装 Docker（如需使用 Docker 运行）。
• 确保已安装 kubectl（如需部署到 Kubernetes）。

安装教程

从源代码安装

git clone https://github.com/yourusername/mcp-k8s-server.git
cd mcp-k8s-server
pip install -e .

使用 pip 安装

pip install mcp-k8s-server

使用 Docker 运行

docker build -t mcp-k8s-server .
docker run -p 8000:8000 -v ~/.kube:/home/mcp/.kube mcp-k8s-server

部署到 Kubernetes

kubectl apply -f k8s/

调试方式

直接运行

mcp-k8s-server --transport sse --port 8000 --host 0.0.0.0 --config /path/to/config.yaml --debug

测试集群内配置

export KUBERNETES_SERVICE_HOST=<kubernetes-api-server-ip>
export KUBERNETES_SERVICE_PORT=<kubernetes-api-server-port>
mkdir -p /var/run/secrets/kubernetes.io/serviceaccount/
kubectl config view --raw -o jsonpath='{.clusters[0].cluster.certificate-authority-data}' | base64 -d > /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
echo "your-service-account-token" > /var/run/secrets/kubernetes.io/serviceaccount/token

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。