feat: Implement profile-based Docker containerization architecture

- Replace separate Docker CLI with integrated workflow profiles
- Add dynamic Dockerfile generation with environment detection
- Implement build-only, build-and-push, and custom dev profiles
- Add comprehensive Docker architecture documentation
- Include full smoke test suite validating end-to-end workflows
- Support both development (local source) and production deployments

This architectural change consolidates Docker functionality into the
main MCPStack workflow system, enabling containerized MCP deployments
through a unified profile-based interface.

Author: dr-shrey

.dockerignore

@@ -0,0 +1,24 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+.venv/
+pip-log.txt
+pip-delete-this-directory.txt
+.mypy_cache/
+.coverage
+.pytest_cache/
+*.egg-info/
+docs/
+assets/
+workflows/
+# README.md - needed for Docker build
+# *.md - some markdown files needed for build
+.git
+.gitignore
+*.log
+tmp/
+Dockerfile*

.gitignore

@@ -67,6 +67,10 @@ config.json
 *config*.json
 m3_pipeline.json
 
+# Generated Docker files (use workflow to generate)
+Dockerfile*
+!src/MCPStack/core/docker/dockerfile_generator.py
+
 # Operating System specific files
 .DS_Store
 Thumbs.db
@@ -80,4 +84,4 @@ Desktop.ini
 
 # Datasets and other large files
 data/
-m3_data/
+m3_data/

README.md

@@ -158,6 +158,87 @@ You can also run your pipeline with FastMCP, allowing you to connect to various
 
 <br />
 
+### `Docker Containerization` 🐳
+
+Build and deploy your MCP pipelines as Docker containers for production environments.
+
+#### Prerequisites
+- **MCPStack**: `uv add mcpstack` or `pip install mcpstack`
+- **Available Presets**: Check with `mcpstack list-presets` (assumes `example_preset` exists)
+- **For full testing**: [Claude Desktop](https://claude.ai/desktop) for MCP server usage
+- **For building images**: Docker CLI installed and available
+
+#### Quick Start Commands
+
+**Basic Config (Fastest setup)** ⭐ *Recommended for first-time users*
+```bash
+# Generate Docker config only - creates claude_desktop_config.json
+mcpstack build --config-type docker --presets example_preset
+```
+*Outputs:* `claude_desktop_config.json` for MCP host configuration
+
+**Development Workflow** 🛠️ *Recommended for local development*
+```bash
+# Generate config, dockerfile, and build image locally
+mcpstack build --config-type docker --presets example_preset --profile build-only
+```
+*Outputs:* `claude_desktop_config.json` + `Dockerfile` + built image for local testing
+
+**Production Pipeline** 🚀 *Recommended for deployment*
+```bash
+# Complete workflow: generate, build, and push container image
+mcpstack build --config-type docker --presets example_preset --profile build-and-push
+```
+*Outputs:* Complete CI/CD pipeline with config, dockerfile, built & pushed container image
+
+#### Verification Steps
+```bash
+# Check available profiles
+mcpstack list-profiles --config-type docker
+
+# After running any command, verify outputs:
+ls -la claude_desktop_config.json Dockerfile  # Check generated files
+docker images | grep mcpstack                    # Check built images
+cat claude_desktop_config.json                  # Config for Claude Desktop
+```
+
+Perfect for deploying MCP tools to Kubernetes, Docker Swarm, or any container orchestration system.
+
+<br />
+
+### `Workflow Profiles` ⚙️
+
+Define and run complex multi-stage workflows beyond basic config generation using workflow profiles.
+
+#### Discover Available Profiles
+```bash
+# List all profiles
+mcpstack list-profiles
+
+# List profiles for specific config type
+mcpstack list-profiles --config-type docker
+```
+
+#### Use Built-in Profiles
+```bash
+# Docker build and push workflow
+mcpstack build --config-type docker --presets example_preset --profile build-and-push
+
+# Docker build-only workflow (local development)
+mcpstack build --config-type docker --presets example_preset --profile build-only
+```
+
+#### Custom Profile Examples
+Check the `workflows/` directory for YAML examples:
+- `docker-dev.yaml` - Development workflow with custom Dockerfile
+- `docker-prod.yaml` - Production CI/CD pipeline with tagging and registry push
+
+Profiles support environment variables like `${GIT_COMMIT}`, `${GIT_BRANCH}`, and `${preset}` for dynamic naming.
+
+Perfect for implementing complex deployment pipelines while maintaining MCPStack's clean architecture.
+
+<br />
+
 <img src="assets/readme/more.gif" width="61.8%" align="left" style="border-radius: 10px;"/>
 
 ### `Many Other CLIs Options`

docs/API/cli/stack_cli.md

@@ -4,6 +4,58 @@
     This page documents the **programmatic** CLI class — handy if you embed the CLI or generate help programmatically.
     For end-user command help, see the **CLI** section of the docs.
 
+## Workflow Profiles
+
+The `build` command supports workflow profiles for executing multi-stage operations beyond basic config generation:
+
+- `--profile NAME`: Run extended workflow profile after basic build
+
+### Profile Discovery
+
+```bash
+# List all available profiles
+mcpstack list-profiles
+
+# List profiles for specific config type
+mcpstack list-profiles --config-type docker
+```
+
+### Profile Examples
+
+```bash
+# Generate Docker config only (basic usage)
+mcpstack build --config-type docker --presets example_preset
+
+# Execute build-and-push workflow profile
+mcpstack build --config-type docker --presets example_preset --profile build-and-push
+
+# Execute build-only workflow profile
+mcpstack build --config-type docker --presets example_preset --profile build-only
+```
+
+### Built-in Docker Profiles
+
+- `build-and-push`: Generate config, dockerfile, build image, push to registry
+- `build-only`: Generate config, dockerfile, build image locally
+
+### Custom Profiles
+
+Create YAML profiles in the `workflows/` directory for complex deployment scenarios:
+
+```yaml
+name: docker-prod
+description: Production deployment with tagging
+config_type: docker
+stages:
+  - config.generate
+  - dockerfile.generate
+  - image.build:
+      image: "${preset}:${GIT_COMMIT}"
+  - image.push:
+      registry: "docker.io"
+      tags: ["latest", "${GIT_BRANCH}"]
+```
+
 ::: MCPStack.cli.StackCLI
     options:
       show_root_heading: true

docs/API/mcp_config_generators/docker.md

@@ -0,0 +1,82 @@
+# DockerMCP Config Generator
+
+::: MCPStack.core.mcp_config_generator.mcp_config_generators.docker_mcp_config.DockerMCPConfigGenerator
+    options:
+      show_root_heading: true
+      show_source: true
+
+## Docker Workflow
+
+The DockerMCP Config Generator provides unified Docker containerization functionality for MCPStack pipelines. It can:
+
+- **Generate configuration files** for running MCPStack tools inside Docker containers (Claude Desktop integration)
+- **Generate Dockerfiles** from MCPStack pipeline configurations
+- **Build Docker images** automatically during configuration generation
+- **Push images** to Docker registries
+- **Support complex configuration** including volumes, ports, networks, and build arguments
+
+## Usage
+
+### Basic Configuration Generation
+```python
+config = DockerMCPConfigGenerator.generate(
+    stack=mcp_stack,
+    image_name="mcpstack:myapp"
+)
+```
+
+### Complete Docker Workflow
+```python
+config = DockerMCPConfigGenerator.generate(
+    stack=mcp_stack,
+    image_name="myapp:latest",
+    build_image="myapp:latest",  # Build the image
+    generate_dockerfile=True,    # Generate Dockerfile
+    docker_push=True,           # Push to registry
+    docker_registry_url="docker.io/username/"
+)
+```
+
+## CLI Integration
+
+The generator integrates with the unified MCPStack CLI through workflow profiles:
+
+```bash
+# Generate Docker config only (basic usage)
+mcpstack build --config-type docker --presets my_preset
+
+# Generate config, dockerfile, build and push (production pipeline)
+mcpstack build --config-type docker --presets my_preset --profile build-and-push
+
+# Generate config, dockerfile, and build locally (development)
+mcpstack build --config-type docker --presets my_preset --profile build-only
+```
+
+## Parameters
+
+### Core Parameters
+- `stack`: MCPStackCore instance
+- `image_name`: Docker image name to use in configurations
+- `server_name`: Name for the MCP server in Claude config
+- `volumes`: Volume mounts for Docker container
+- `ports`: Port mappings for Docker container
+- `network`: Docker network name
+
+### Docker Building Parameters
+- `build_image`: Image name to build (triggers Docker build)
+- `generate_dockerfile`: Generate Dockerfile when True
+- `dockerfile_path`: Custom path for generated Dockerfile
+- `docker_push`: Push built image to registry
+- `docker_registry_url`: Docker registry URL
+- `build_args`: Dictionary of Docker build arguments
+
+## Integration with MCP Config Generators Registry
+
+The DockerMCP Config Generator is automatically available through the MCP config generators registry:
+
+```python
+from MCPStack.core.mcp_config_generator.registry import ALL_MCP_CONFIG_GENERATORS
+
+# The DockerMCP generator is registered as 'docker'
+generator = ALL_MCP_CONFIG_GENERATORS['docker']
+config = generator.generate(stack, build_image="myimage:latest")