Cloud Native MCP Server

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

GitHub 仓库快速开始

核心价值#

统一运维入口

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

面向生产的安全策略

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

对 AI Agent 友好

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

典型使用场景#

故障定位与快速止血

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

发布与变更管控

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

可观测性协同分析

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

项目概览#

集成服务

220+

MCP 工具

运行模式

MIT

开源许可

集成服务#

Kubernetes 28 工具

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

Helm 31 工具

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

Grafana 36 工具

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

Prometheus 20 工具

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

Kibana 52 工具

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

Elasticsearch 14 工具

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

Alertmanager 15 工具

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

Jaeger 8 工具

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

OpenTelemetry 9 工具

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

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 连接异常、服务不可用等高频问题的排查路径和命令清单。

进入排障