K8s Lab MCP

k8s实验室MCP服务器

A. 模型上下文协议（MCP） k8s实验室项目的服务器。它暴露了 只读Kubernetes集群可见性, Grafana Loki日志访问，以及 普罗米修斯指标API（v1） 到编码代理（例如Cursor） 超文本传输协议 使用Streamable传输，因此助手可以在没有shell访问的情况下检查工作负载、日志和指标。

堆放和运输

MCP服务器元数据 application.yaml: spring.ai.mcp.server — protocol: streamable, stdio: false, type: sync, version: 0.1.1.

弹簧靴执行器暴露 health 和 info 在管理web基本路径下（默认值适用）。

配置

HTTP服务客户端(spring.http.serviceclient)

弹簧靴绑定 base-url, connect-timeout，以及 read-timeout 每 客户名称。名称必须与 group 在 @ImportHttpServices(group = "…", …) 关于相应 @Configuration 班级(loki → LokiLogQueries, prometheus → PrometheusMetricQueries).

洛基 (spring.http.serviceclient.loki):

• base-url --默认值 http://loki.k8s.lab
• connect-timeout, read-timeout --默认值 10s / 30s

普罗米修斯 (spring.http.serviceclient.prometheus):

• base-url --默认值 http://prometheus.k8s.lab （仅限原产地；API前缀 /api/v1 继续存在 PrometheusMetricQueries，不在 base-url)
• connect-timeout, read-timeout --默认值 10s / 30s

可选Grafana基本身份验证 对于洛基(mcp.monitoring.loki):

• username / password --经常从env绑定 GRAFANA_USERNAME 和 GRAFANA_PASSWORD （参见 application.yaml)

Kubernetes客户端 （Fabric8使用标准的kubeconfig发现，除非被覆盖）：

• 在Docker中(Dockerfile), KUBECONFIG=/app/kubeconfig 为绑定挂载的kubeconfig设置。

MCP Kubernetes调优 (mcp.kubernetes):

• max-events --帽子 get-events （默认值 500)
• connection-timeout, read-timeout -API服务器超时（默认值 10s / 30s)

洛基/普罗米修斯JSON和MCP客户端 (mcp.tool-response):

• serialize-top-level-data-json-array （默认值 true)--当工具输出为具有顶级JSON时 data 数组，它可以被重写为JSON字符串，这样一些MCP客户端就可以保留有效载荷。吃起来 false 如果你需要原始的洛基风格数组。

当前工具（已实施）

集群（通过Fabric8的Kubernetes API）

top-nodes 和 top-pods 需要 度量服务器 在集群中；否则，工具将返回一个明确的错误字符串。

实施生活在 SystemTools → ClusterResourceService → Fabric8ClusterResourceQueries.

日志（Loki HTTP API）

时间戳是 Unix纪元纳秒 除非特别注明。Loki的响应返回为 JSON文本 对于模型（取决于 mcp.tool-response 上文）。

实施生活在 LogTools → LokiLogService → LokiLogQueries.

度量（Prometheus HTTP API v1）

答案是 普罗米修斯JSON (status, data等等）作为文本。查询次数使用 RFC3339或Unix秒 如在普罗米修斯API中。旨在 kube-prometheus堆栈 或任何暴露该标准的服务器 **/api/v1/*** 路线。

注： 如果你打电话 prometheus-rules 带着一个 group_limit 查询参数，Prometheus要求它是 大于零; 0 回报 400 bad_data.

实施生活在 MetricTools → PrometheusMetricService → PrometheusMetricQueries (@HttpExchange("/api/v1"))，通过以下方式连接 PrometheusHttpClientConfiguration 和 spring.http.serviceclient.prometheus.

在集群中运行

群集设置： 从以下位置提供K8s实验室平台（多节点K3、监控、GitOps和相关布线） 尼利斯/集群基础设施该存储库是VM、k3s、Argo CD、Jenkins和可观测性堆栈的真实来源；在对实验室运行此MCP服务器之前部署它。

运行时间期望： 服务器旨在运行 旁边 集群（例如，在Jenkins/build主机或其他可以访问Kubernetes API、Loki和Prometheus的虚拟机上），不一定是集群内的Pod，尽管如果安装凭据并指向 spring.http.serviceclient.loki.base-url 和 spring.http.serviceclient.prometheus.base-url 可解析URL（在集群服务或实验室DNS中，如 loki.k8s.lab / prometheus.k8s.lab).

1. 塑造形象 从该目录（请参见 Dockerfile):

   cd mcp
   docker build -t mcp-server:latest .

1. 运行容器 带着一个 只读kubeconfig 安装在图像所需的位置(KUBECONFIG=/app/kubeconfig):

   docker run -d \
     --name mcp-server \
     --restart=unless-stopped \
     --memory=512m --memory-swap=512m \
     --network=host \
     -e SPRING_PROFILES_ACTIVE=runner \
     -e GRAFANA_USERNAME="..." \
     -e GRAFANA_PASSWORD="..." \
     -v /path/to/kubeconfig:/app/kubeconfig:ro \
     mcp-server:latest

使用 --network=host （或其他网络模式），因此主机名如下 loki.k8s.lab 和 prometheus.k8s.lab 从 application.yaml 解决方法与在实验室机器上相同。如果Loki在您的网络上打开，请省略或调整Grafana env变量。

1. 验证： 执行器健康状况和MCP HTTP端点（典型路径）：

- http://:9000/actuator/health - http://:9000/mcp

图像详细信息： Dockerfile 将JAR打包为 -Xmx384m，用户 mcp，暴露端口 9000.

计划功能（尚未实施）

这些匹配中的空工具类和注释配置 application.yaml他们是 路线图 物品，而不是装运的工具。

实施后，此部分应缩小，工具应移入 当前工具 具有精确的参数和支持API。