How vishalnotfound/docker2k8s-mcp works
docker2k8s-mcp is an MCP server that gives an LLM tools to inspect a Docker/Compose project, plan and generate Kubernetes resources, validate them, and—after explicit user approval—deploy, verify, and diagnose them. The README documents this workflow and additional inspection, environment, and diagnosis capabilities. Sampled source confirms server registration, generation and deployment validation, and Kubernetes access; unsampled tool and service internals are represented only where documented, with uncertain links omitted.
Main entry points: k8s_service.py Kubernetes operations · server.py MCP server · deployment.py Cluster tools · kubernetes.py Manifest tools
Components 20
MCP Interface
- MCP server
src/server.py - Project tools
src/tools/docker.py - Planning tools
src/tools/migration.py - Manifest tools
src/tools/kubernetes.py - Cluster tools
src/tools/deployment.py
Migration Planning
- Project inspection
src/services/docker_service.py - Migration planning
src/services/migration_service.py - Path and secret safety
src/security.py - Migration data models
src/schemas.py
Manifest Production
- Kubernetes generator
src/generators/kubernetes.py - Manifest validator
src/validators/kubernetes.py - Generated manifests
generated
Cluster Operations
- Kubernetes operations
src/services/k8s_service.py - Deployment diagnosis
src/services
Other components
- User
- LLM / MCP client
- Docker project
- Filesystem and YAML
- Kubernetes cluster
- kubectl
Connections 26
- User → LLM / MCP client: requests migration
- LLM / MCP client → MCP server: calls tools
- MCP server → Project tools: registers
- MCP server → Planning tools: registers
- MCP server → Manifest tools: registers
- MCP server → Cluster tools: registers
- Project tools → Project inspection: inspects project
- Project inspection → Path and secret safety: checks paths, redacts
- Project inspection → Filesystem and YAML: reads project files
- Docker project → Filesystem and YAML: provides files
- Planning tools → Migration planning: creates plan
- Migration planning → Project inspection: uses inspection
- Migration planning → Migration data models: builds plan
- Manifest tools → Migration planning: derives plan
- Manifest tools → Kubernetes generator: generates manifests
- Kubernetes generator → Generated manifests: writes YAML
- Manifest tools → Manifest validator: validates manifests
- Cluster tools → Manifest validator: checks before apply
- Cluster tools → Kubernetes operations: deploys and observes
- Kubernetes operations → Generated manifests: reads manifests
- Kubernetes operations → kubectl: applies manifests
- Kubernetes operations → Kubernetes cluster: queries cluster
- Cluster tools → Deployment diagnosis: requests diagnosis
- Deployment diagnosis → Kubernetes operations: uses cluster observations
- User → Cluster tools: approves deployment
- Kubernetes operations → LLM / MCP client: returns status and evidence