MCP K8s Server

MCP Kubernetes Server是一个基于Python的Kubernetes管理服务器，提供集群信息查询、资源操作、状态监控和分析功能，支持通过MCP协议访问Kubernetes资源。

开发者工具云平台 #K8s管理 #MCP协议 #集群监控 #资源分析 .Python

评分 : 2.5分

下载量 : 4.6K

更新时间 : 2025-04-28

打开站点

什么是MCP Kubernetes Server?

MCP Kubernetes Server是一个智能化的Kubernetes管理工具，通过标准化的Model Context Protocol协议提供对Kubernetes集群的全面管理能力。它可以帮助用户轻松获取集群信息、执行操作、监控状态和分析资源。

如何使用MCP Kubernetes Server?

您可以通过多种方式使用MCP Kubernetes Server: 直接运行Python程序、使用Docker容器部署，或将其部署到Kubernetes集群中。服务器启动后会提供标准化的MCP接口，您可以通过这些接口与Kubernetes集群交互。

适用场景

适用于需要集中管理多个Kubernetes集群的运维团队、希望自动化Kubernetes操作流程的开发人员，以及需要深入分析集群状态的技术专家。

主要功能

集群信息查询

获取Kubernetes资源(Pod、Deployment、Service等)的详细信息

集群操作

对Kubernetes资源执行创建、更新、删除、扩缩容等操作

监控

监控Kubernetes集群和资源的状态

分析

分析Kubernetes资源并提供优化建议

优势

统一的MCP协议接口，易于集成

支持多种部署方式(本地、Docker、Kubernetes)

提供丰富的集群分析和监控功能

内置常见Kubernetes操作提示

局限性

需要Python 3.12+环境

对Kubernetes RBAC权限要求较高

部分高级功能需要集群监控组件支持

如何使用

安装

通过pip安装或从源代码构建

配置

配置Kubernetes访问权限，可以通过kubeconfig文件或使用in-cluster配置

启动服务器

运行服务器并选择传输协议(SSE或STDIO)

连接客户端

使用支持MCP协议的客户端连接服务器

使用案例

获取集群节点信息

查询集群中所有节点的状态和资源使用情况

检查Pod异常

分析指定命名空间中状态异常的Pod

部署扩缩容

调整Deployment的副本数量

常见问题

如何解决权限不足的问题?

支持哪些Kubernetes版本?

如何获取资源的历史变更记录?

🚀 MCP-K8S 服务器

MCP-K8S 是一款基于 Python 的 Kubernetes 资源管理工具，借助模型上下文协议（Model Context Protocol, MCP），实现对 Kubernetes 集群资源的便捷访问与操作。它支持多种资源类型，提供了丰富的功能，可高效管理和监控 Kubernetes 资源。

🚀 快速开始

启动服务器

使用以下命令启动 MCP-K8S 服务器：

python -m mcp_k8s_server.run --kube-config ~/.kube/config

默认情况下，服务器将在 http://localhost:8000 地址上运行。

配置文件

您可通过编辑配置文件来自定义服务器行为，配置文件格式如下：

# config.yaml
server:
  name: mcp-k8s-server
  transport: both  # 支持 stdio、sse 或两者
  port: 8000
  host: 0.0.0.0

kubernetes:
  config_path: ~/.kube/config
  context: default
  namespace: default

测试连接

服务器启动后，可通过访问 http://localhost:8000 或使用 MCP 客户端工具与之交互。

✨ 主要特性

MCP-K8S 服务器具备以下功能：

资源信息

get_resources：获取指定类型的所有资源。
get_resource：获取特定资源的详细信息。
get_namespaces：获取所有可用命名空间。
get_events：获取集群中的所有事件。

资源操作

create_pod：创建新的 pod。
delete_pod：删除指定 pod。
update_deployment：更新 deployment 的配置。
scale_deployment：调整 deployment 的副本数量。

集群监控

list_nodes：获取所有节点的信息。
get_node_status：获取指定节点的状态。
get_cluster_events：获取集群范围内的所有事件。
watch_resources：实时监控资源的变化。

📦 安装指南

要安装 MCP-K8S 服务器，请运行以下命令：

pip install mcp-k8s-server

💻 使用示例

基础用法

from mcp_k8s_server.client import MCPClient

client = MCPClient("http://localhost:8000")
pod_info = client.get_resource("k8s://default/pods/my-pod")
namespace_list = client.get_namespaces()

📚 详细文档

资源 URI 模式

MCP-K8S 服务器支持以下资源 URI 模式：

命名空间内资源

k8s://{namespace}/{resource_type}：获取指定命名空间中特定类型的所有资源。
- 示例：k8s://default/pods，可获取默认命名空间中的所有 pod。
k8s:///{namespace}/{resource_type}/{name}：获取指定命名空间内特定类型的单个资源。
- 示例：k8s://default/deployments/nginx，可获取默认命名空间中名为 nginx 的 deployment。

集群范围资源

k8s:///{resource_type}：获取集群范围内所有特定类型的所有资源。
- 示例：k8s:///nodes，可获取集群中的所有节点。
k8s:///{resource_type}/{name}：获取集群范围内特定类型的单个资源。
- 示例：k8s:///nodes/worker-1，可获取名为 worker-1 的节点。