Cloud Native MCP Server

面向 Kubernetes 与云原生基础设施管理的生产级 MCP 服务器，聚合 15 个服务与 327 个工具，支持 SSE / Streamable-HTTP 两种运行模式。

GitHub 仓库快速开始

核心价值#

统一运维入口

将 Kubernetes、Helm、Grafana、Prometheus、Kibana 等能力收敛到单一 MCP 接口，减少跨系统切换成本。

面向生产的安全策略

支持 apikey / bearer / basic 认证、速率限制与审计日志，便于在企业环境中落地安全合规要求。

对 AI Agent 友好

内置分页与摘要能力，降低上下文爆炸风险，让大模型在复杂排障中保持稳定输出。

典型使用场景#

故障定位与快速止血

聚合查看 Pod 状态、事件、日志与监控指标，缩短从告警到定位根因的路径。

发布与变更管控

通过 Helm 与 Kubernetes 工具链执行发布、回滚、扩缩容，并保留审计痕迹。

可观测性协同分析

跨 Prometheus、Grafana、Loki、Jaeger、Langfuse、Sentry、OpenTelemetry 联动，串联指标、日志与链路数据。

项目概览#

集成服务

327

MCP 工具

运行模式

MIT

开源许可

集成服务#

Kubernetes 34 工具

容器编排、资源查询与集群运维任务。

Helm 34 工具

应用包生命周期管理与发布流程支持。

Argo CD 7 工具

面向 GitOps 的应用、项目、集群与 manifest 检查。

Grafana 55 工具

仪表盘、可视化与告警配置管理。

Prometheus 20 工具

指标查询、规则排查与监控数据运维。

Loki 7 工具

面向日志优先排障的 LogQL 查询、标签发现与日志流检查。

Kibana 73 工具

日志分析与 Elastic 生态可观测性探索。

Elasticsearch 12 工具

索引管理、搜索调试与集群检查。

Alertmanager 16 工具

告警路由、静默策略与通知链路管理。

Jaeger 8 工具

分布式链路追踪与延迟路径分析。

Nacos 9 工具

命名空间、配置、服务发现、实例与节点状态检查。

Langfuse 37 工具

面向 LLM 场景的 Trace、Session、Prompt、评分、指标、项目、成员与密钥管理。

Sentry 9 工具

面向错误监控的 Issue 排障、事件检查与项目发现。

OpenTelemetry 12 工具

指标、日志、追踪的采集链路检查。

Utilities 6 工具

通用辅助工具，覆盖日常运维场景。

快速开始#

Docker

1
2
3
4
5
6
7
8
docker run -d \
  --name cloud-native-mcp-server \
  -p 8080:8080 \
  -v ~/.kube:/root/.kube:ro \
  -e MCP_AUTH_ENABLED=true \
  -e MCP_AUTH_MODE=apikey \
  -e MCP_AUTH_API_KEY='ChangeMe-Strong-Key-123!' \
  mahmutabi/cloud-native-mcp-server:latest

二进制

1
2
3
curl -LO https://github.com/mahmut-Abi/cloud-native-mcp-server/releases/latest/download/cloud-native-mcp-server-linux-amd64
chmod +x cloud-native-mcp-server-linux-amd64
./cloud-native-mcp-server-linux-amd64 --mode=sse --addr=0.0.0.0:8080

源码

1
2
3
4
git clone https://github.com/mahmut-Abi/cloud-native-mcp-server.git
cd cloud-native-mcp-server
make build
./cloud-native-mcp-server --mode=streamable-http --addr=0.0.0.0:8080

可用性验证#

1
2
3
4
5
# 1) 健康检查
curl -sS http://127.0.0.1:8080/health

# 2) SSE 握手与 initialize 全链路验证（在仓库根目录执行）
make sse-smoke BASE_URL=http://127.0.0.1:8080

常用入口#

SSE 聚合端点（--mode=sse）: http://127.0.0.1:8080/api/aggregate/sse
Streamable-HTTP 聚合端点（--mode=streamable-http）: http://127.0.0.1:8080/api/aggregate/streamable-http
健康检查: http://127.0.0.1:8080/health

上线前检查清单#

认证与权限

启用 `MCP_AUTH_ENABLED=true`。
使用 `apikey` / `bearer` / `basic` 模式之一。
最小化 Kubernetes 与第三方系统权限范围。

可观测性与审计

开启结构化日志与必要的指标采集。
根据审计要求启用审计日志与存储策略。
确认 `/health` 与关键服务检查稳定。

性能与稳定性

按业务压力调优限流、超时与并发参数。
优先使用分页与摘要工具降低上下文体积。
压测时覆盖高峰期真实工具调用组合。

文档导航#

常见问题与排障入口#

快速开始 FAQ

覆盖认证模式、运行模式选择、连接方式和上线建议，适合首次接入团队快速统一认知。

查看 FAQ

故障排除手册

提供启动失败、401、SSE 连接异常、服务不可用等高频问题的排查路径和命令清单。

进入排障