Chaos Mesh MCP Server

Chaos Mesh MCP 服务端，基于 Python FastMCP 实现，提供 Chaos Mesh 混沌实验的 MCP 工具集。

项目结构

chaosmesh-mcp/
├── src/
│   └── chaosmesh_mcp/          # 源代码 (src 布局)
│       ├── __init__.py
│       ├── __main__.py          # python -m 入口
│       ├── server.py            # FastMCP 服务启动
│       ├── tools/               # MCP 工具注册
│       │   ├── chaos.py         # list_chaos / delete_chaos
│       │   ├── cluster.py       # 集群巡检 (namespace/pod/node)
│       │   ├── httpchaos.py     # HTTP 接口级延迟注入
│       │   ├── network_chaos.py # 网络延迟/丢包/外部延迟
│       │   └── pod.py           # Pod Kill 注入
│       ├── services/            # 服务适配层
│       │   ├── kubectl.py       # kubectl 命令封装
│       │   └── chaosmesh.py     # 模板渲染与 Chaos CRD 应用
│       ├── utils/               # 工具函数
│       │   ├── generate.py      # 混沌资源名生成
│       │   ├── response.py      # 统一响应格式
│       │   └── validate.py      # 输入校验
│       └── templates/           # Chaos Mesh YAML 模板
│           ├── network_delay.yaml
│           ├── network_loss.yaml
│           ├── network_external_delay.yaml
│           ├── pod_kill.yaml
│           └── httpchaos_delay.yaml
├── tests/
│   └── __init__.py
├── deploy/k8s/                  # Kubernetes 部署清单
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── ingress.yaml
│   ├── kustomization.yaml
│   ├── kustomizeconfig.yaml
│   ├── .env.config
│   └── .env.secret.example
├── pyproject.toml
├── uv.lock
├── .python-version
├── Dockerfile
└── README.md

运行方式

环境准备

# 确保已安装 uv
uv --version

# 同步依赖（自动创建 .venv 并安装所有依赖）
uv sync

本地运行

# 使用 uv run 启动服务
uv run python -m chaosmesh_mcp

# 或通过 console_scripts
uv run chaosmesh-mcp

Docker

docker build -t chaos-mcp:latest .
docker run -p 8000:8000 chaos-mcp:latest

环境变量

• MCP_HOST — 服务监听地址，默认 0.0.0.0
• MCP_PORT — 服务监听端口，默认 8000

功能说明

集群巡检工具 (tools/cluster.py)

• get_namespaces — 查询集群中的 namespace 列表
• get_pods — 以 wide 格式列出目标命名空间中的 Pod
• get_nodes — 以 wide 格式列出集群中的所有节点
• cluster_info — 获取 Kubernetes 集群端点与服务信息

网络混沌工具 (tools/network_chaos.py)

• resolve_namespace — 根据 K8s 服务名称查询所在的 namespace
• network_delay — 对服务与服务之间的网络连接注入延迟
• network_external_delay — 对发往第三方渠道域名注入响应延迟 (Workflow)
• network_loss — 对服务间注入 NetworkChaos 丢包故障

HTTP 混沌工具 (tools/httpchaos.py)

• httpchaos_delay — 按 HTTP 路径和端口精准注入延迟

Pod 混沌工具 (tools/pod.py)

• pod_kill — PodChaos pod-kill 故障注入

混沌生命周期工具 (tools/chaos.py)

• list_chaos — 列出指定命名空间中的混沌资源
• delete_chaos — 按类型、名称和命名空间删除单个混沌资源

响应格式

所有工具返回统一的 JSON 响应：

{
  "success": true,
  "message": "操作描述",
  "data": {
    "kubectl": "kubectl 返回内容",
    "yaml": "渲染后的 YAML"
  },
  "yaml": "渲染后的 YAML (顶层)"
}

Kubernetes 部署

kubectl create namespace chaos-mcp
cp deploy/k8s/.env.secret.example deploy/k8s/.env.secret
# 编辑 deploy/k8s/.env.secret 填入真实值
kubectl apply -k deploy/k8s