rohitg00/kubectl-mcp-server

Major refactoring to improve maintainability and code organization.

Architecture Changes

• Modularized mcp_server.py from ~7,400 lines to ~450 lines

• Extracted 121 tools into 11 category modules in tools/:
  | Module | Description | Tools |
  |--------|-------------|-------|
  | pods.py | Pod management and diagnostics | 11 |
  | deployments.py | Deployments, StatefulSets, DaemonSets, Jobs | 10 |
  | core.py | Namespaces, ConfigMaps, Secrets, Events | 6 |
  | cluster.py | Context/cluster management | 11 |
  | networking.py | Services, Ingress, NetworkPolicies | 8 |
  | storage.py | PVCs, StorageClasses, PVs | 3 |
  | security.py | RBAC, ServiceAccounts, PodSecurity | 10 |
  | helm.py | Complete Helm v3 operations | 37 |
  | operations.py | kubectl apply/patch/describe/rollout | 15 |
  | diagnostics.py | Metrics and namespace comparison | 3 |
  | cost.py | Resource optimization and cost analysis | 9 |

• Extracted resources into resources/resources.py (8 MCP resources)

• Extracted prompts into prompts/prompts.py (8 MCP prompts)

• Added utils/helpers.py for shared utilities

Testing

• 138 tests passing
• Added comprehensive tool registration tests
• Verifies all 121 tools are registered correctly

Documentation

• Updated README with modular architecture diagram
• Updated tool count to 121

Installation

# npm/npx
npx kubectl-mcp-server

# pip
pip install kubectl-mcp-tool==1.9.0

# Docker
docker pull rohitghumare64/kubectl-mcp-server:v1.9.0