kubernetes-mcp
Query Kubernetes resources for diagnostics, verification, and infrastructure validation.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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
- Always specify namespace - Avoid cluster-wide queries
- Check status fields - Not just existence
- Use label selectors - Filter relevant resources
- Verify before proceeding - Wait for Ready status
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-03-04
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!