# Kubernetes MCP

> Query Kubernetes resources for diagnostics, verification, and infrastructure validation.

- Skill: `majiayu000/kubernetes-mcp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/kubernetes-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/kubernetes-mcp/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/kubernetes-mcp

---


# Kubernetes MCP (Cluster Operations)

Use Kubernetes MCP tools to query cluster resources for diagnostics and verification.

## Tools

| Tool | Purpose |
|------|---------|
| `kubernetes_listResources` | List resources of a specific type |
| `kubernetes_getResource` | Get detailed resource info |

## Listing Resources

```
# List all pods in a namespace
kubernetes_listResources({
  kind: "Pod",
  namespace: "my-service"
})

# List deployments
kubernetes_listResources({
  kind: "Deployment",
  namespace: "my-service"
})
```

## Getting Resource Details

```
# Get pod details
kubernetes_getResource({
  kind: "Pod",
  name: "my-service-abc123",
  namespace: "my-service"
})

# Get service endpoints
kubernetes_getResource({
  kind: "Service",
  name: "my-service",
  namespace: "my-service"
})
```

## Common Resources

| Resource | Use Case |
|----------|----------|
| **Pod** | Check running containers, logs |
| **Deployment** | Verify replicas, rollout status |
| **Service** | Check endpoints, ports |
| **ConfigMap** | Read configuration values |
| **Secret** | Verify secret existence (not values) |
| **PersistentVolumeClaim** | Check storage provisioning |
| **Cluster** | Database cluster status (CloudNative-PG) |

## Infrastructure Verification

```
# Verify database is ready
kubernetes_getResource({
  kind: "Cluster",
  name: "my-db",
  namespace: "my-service"
})
# Check: status.phase == "Cluster in healthy state"

# Verify Redis is running
kubernetes_listResources({
  kind: "Pod",
  namespace: "my-service",
  labelSelector: "app=redis"
})
```

## Best Practices

1. **Always specify namespace** - Avoid cluster-wide queries
2. **Check status fields** - Not just existence
3. **Use label selectors** - Filter relevant resources
4. **Verify before proceeding** - Wait for Ready status