feat: v0.8.0 - Compose Completeness

Add 16 new Compose MCP tools covering every remaining Docker Compose V2 command: config, cp, create, events, images, kill, ls, pause, unpause, port, rm, run, scale, start, stop, top.

Add compose-scaling rule for flagging scaling blockers. Total: 84 MCP tools, 14 skills, 9 rules.

Made-with: Cursor

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "docker-developer-tools",
   "displayName": "Docker Developer Tools",
-  "version": "0.7.0",
-  "description": "A Cursor plugin for Docker and container workflows - 14 skills, 8 rules, and 68 MCP tools for building, debugging, optimizing, and managing Docker containers, images, networks, and volumes. Includes a companion MCP server (docker-mcp) for live Docker CLI integration.",
+  "version": "0.8.0",
+  "description": "A Cursor plugin for Docker and container workflows - 14 skills, 9 rules, and 84 MCP tools for building, debugging, optimizing, and managing Docker containers, images, networks, and volumes. Includes a companion MCP server (docker-mcp) for live Docker CLI integration.",
   "author": {
     "name": "TMHSDigital",
     "url": "https://github.com/TMHSDigital"

CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0] - 2026-03-29
+
+### Added
+
+#### MCP Server - Compose Completeness (+16, total 84)
+- `docker_composeConfig` - validate, resolve, and render a Compose file in canonical format (yaml/json output)
+- `docker_composeCp` - copy files between a Compose service container and the local filesystem (archive, index options)
+- `docker_composeCreate` - create Compose service containers without starting them (build, force-recreate, pull policy)
+- `docker_composeEvents` - receive real-time events from Compose containers (JSON format, service filter)
+- `docker_composeImages` - list images used by Compose service containers (JSON format)
+- `docker_composeKill` - force stop Compose service containers with configurable signal
+- `docker_composeLs` - list running Compose projects (all, filter options)
+- `docker_composePause` - pause Compose services
+- `docker_composeUnpause` - unpause Compose services
+- `docker_composePort` - print the public port for a Compose service port binding (tcp/udp protocol)
+- `docker_composeRm` - remove stopped Compose service containers (stop, volumes options)
+- `docker_composeRun` - run a one-off command on a Compose service (rm, detach, user, env, workdir, no-deps)
+- `docker_composeScale` - scale Compose services to a specified replica count via up --scale
+- `docker_composeStart` - start existing Compose service containers
+- `docker_composeStop` - stop Compose services without removing containers (timeout option)
+- `docker_composeTop` - display running processes in Compose service containers
+
+#### Plugin
+- `compose-scaling` rule - flag scaling blockers: container_name preventing replicas, fixed host ports, missing resource limits, missing restart policy
+
+---
+
 ## [0.7.0] - 2026-03-29
 
 ### Added
@@ -207,6 +234,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Python test suite: plugin manifest, skills, rules, docs consistency, internal links, roadmap
 - Vitest test suite: error classes, docker-api utilities, input validation
 
+[0.8.0]: https://github.com/TMHSDigital/Docker-Developer-Tools/releases/tag/v0.8.0
 [0.7.0]: https://github.com/TMHSDigital/Docker-Developer-Tools/releases/tag/v0.7.0
 [0.6.0]: https://github.com/TMHSDigital/Docker-Developer-Tools/releases/tag/v0.6.0
 [0.5.0]: https://github.com/TMHSDigital/Docker-Developer-Tools/releases/tag/v0.5.0

CLAUDE.md

@@ -4,11 +4,11 @@ Project documentation for Claude Code and AI assistants working on this reposito
 
 ## Project Overview
 
-Docker Developer Tools is a Cursor IDE plugin that integrates Docker and container workflows into Cursor's AI chat. It includes 14 skills, 8 rules, and a companion MCP server with 68 tools for live Docker CLI integration.
+Docker Developer Tools is a Cursor IDE plugin that integrates Docker and container workflows into Cursor's AI chat. It includes 14 skills, 9 rules, and a companion MCP server with 84 tools for live Docker CLI integration.
 
 This is a monorepo - the Cursor plugin (skills and rules) and the companion MCP server live in the same repository. Docker's API is local (Docker Engine socket / CLI), so one repo is simpler for users to install and maintain.
 
-**Version:** 0.7.0
+**Version:** 0.8.0
 **License:** CC-BY-NC-ND-4.0
 **Author:** TMHSDigital
 
@@ -54,7 +54,7 @@ Docker-Developer-Tools/
 | `docker-advanced-workflows` | Multi-stage pipelines, sidecar patterns, healthchecks, signal handling |
 | `docker-multi-platform` | Multi-arch builds, buildx configuration, manifest lists, platform targeting |
 
-## Rules (8)
+## Rules (9)
 
 | Rule | Scope | Description |
 |------|-------|-------------|
@@ -66,8 +66,9 @@ Docker-Developer-Tools/
 | `docker-port-conflicts` | Dockerfiles, compose files | Flag port conflicts |
 | `docker-logging` | Dockerfiles, compose files | Flag missing logging drivers and log rotation |
 | `buildx-best-practices` | Dockerfiles, compose files | Flag multi-platform build issues, missing cache config |
+| `compose-scaling` | Compose files | Flag scaling blockers: container_name, fixed host ports, missing limits |
 
-## MCP Server (68 tools)
+## MCP Server (84 tools)
 
 The MCP server talks to Docker via CLI exec (`docker` commands) rather than the Docker Engine REST API. It uses stdio transport and requires `docker` to be available on PATH.
 
@@ -114,7 +115,7 @@ The MCP server talks to Docker via CLI exec (`docker` commands) rather than the
 | `docker_save` | Save images to a tar archive |
 | `docker_load` | Load images from a tar archive |
 
-### Compose (8)
+### Compose (24)
 
 | Tool | Description |
 |------|-------------|
@@ -126,6 +127,22 @@ The MCP server talks to Docker via CLI exec (`docker` commands) rather than the
 | `docker_composeRestart` | Restart Compose services |
 | `docker_composePull` | Pull images for Compose services |
 | `docker_composeExec` | Execute a command in a running Compose service |
+| `docker_composeConfig` | Validate, resolve, and render a Compose file |
+| `docker_composeCp` | Copy files between service container and host |
+| `docker_composeCreate` | Create service containers without starting |
+| `docker_composeEvents` | Real-time events from Compose containers |
+| `docker_composeImages` | List images used by Compose services |
+| `docker_composeKill` | Force stop Compose service containers |
+| `docker_composeLs` | List running Compose projects |
+| `docker_composePause` | Pause Compose services |
+| `docker_composeUnpause` | Unpause Compose services |
+| `docker_composePort` | Print public port for a service binding |
+| `docker_composeRm` | Remove stopped service containers |
+| `docker_composeRun` | Run a one-off command on a service |
+| `docker_composeScale` | Scale services to a replica count |
+| `docker_composeStart` | Start existing service containers |
+| `docker_composeStop` | Stop services without removing |
+| `docker_composeTop` | Running processes per service |
 
 ### Volume Management (4)
 
@@ -294,6 +311,22 @@ Full checklist with copy-paste commands: [CONTRIBUTING.md - Release Checklist](C
 | `docker compose restart` | `docker_composeRestart` |
 | `docker compose pull` | `docker_composePull` |
 | `docker compose exec` | `docker_composeExec` |
+| `docker compose config` | `docker_composeConfig` |
+| `docker compose cp` | `docker_composeCp` |
+| `docker compose create` | `docker_composeCreate` |
+| `docker compose events --json` | `docker_composeEvents` |
+| `docker compose images --format json` | `docker_composeImages` |
+| `docker compose kill` | `docker_composeKill` |
+| `docker compose ls --format json` | `docker_composeLs` |
+| `docker compose pause` | `docker_composePause` |
+| `docker compose unpause` | `docker_composeUnpause` |
+| `docker compose port` | `docker_composePort` |
+| `docker compose rm -f` | `docker_composeRm` |
+| `docker compose run --no-TTY` | `docker_composeRun` |
+| `docker compose up -d --scale` | `docker_composeScale` |
+| `docker compose start` | `docker_composeStart` |
+| `docker compose stop` | `docker_composeStop` |
+| `docker compose top` | `docker_composeTop` |
 | `docker volume create` | `docker_volumeCreate` |
 | `docker volume rm` | `docker_volumeRm` |
 | `docker volume inspect` | `docker_volumeInspect` |

README.md

@@ -11,7 +11,7 @@
 <p align="center">
   <a href="https://github.com/TMHSDigital/Docker-Developer-Tools/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/TMHSDigital/Docker-Developer-Tools/validate.yml?branch=main&label=CI" alt="CI" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-blue" alt="License" /></a>
-  <img src="https://img.shields.io/badge/version-0.7.0-green" alt="Version" />
+  <img src="https://img.shields.io/badge/version-0.8.0-green" alt="Version" />
   <a href="https://www.npmjs.com/package/@tmhs/docker-mcp"><img src="https://img.shields.io/npm/v/@tmhs/docker-mcp" alt="npm" /></a>
   <a href="https://www.npmjs.com/package/@tmhs/docker-mcp"><img src="https://img.shields.io/npm/dm/@tmhs/docker-mcp" alt="npm downloads" /></a>
   <a href="https://www.npmjs.com/package/@tmhs/docker-mcp"><img src="https://img.shields.io/npm/unpacked-size/@tmhs/docker-mcp" alt="npm size" /></a>
@@ -22,7 +22,7 @@
 </p>
 
 <p align="center">
-  <strong>14 skills</strong>&nbsp;&bull;&nbsp;<strong>8 rules</strong>&nbsp;&bull;&nbsp;<strong>68 MCP tools</strong>
+  <strong>14 skills</strong>&nbsp;&bull;&nbsp;<strong>9 rules</strong>&nbsp;&bull;&nbsp;<strong>84 MCP tools</strong>
 </p>
 
 ---
@@ -74,7 +74,7 @@ flowchart LR
 </details>
 
 <details>
-<summary><strong>8 Rules</strong> - automatic best-practice enforcement</summary>
+<summary><strong>9 Rules</strong> - automatic best-practice enforcement</summary>
 
 &nbsp;
 
@@ -88,6 +88,7 @@ flowchart LR
 | `docker-port-conflicts` | Dockerfiles, compose files | Flag commonly conflicting port mappings |
 | `docker-logging` | Dockerfiles, compose files | Flag missing logging drivers and log rotation |
 | `buildx-best-practices` | Dockerfiles, compose files | Flag multi-platform build issues, missing cache config, arch hardcoding |
+| `compose-scaling` | Compose files | Flag scaling blockers: container_name, fixed host ports, missing limits |
 
 </details>
 
@@ -117,7 +118,7 @@ Add to your Cursor MCP config (`.cursor/mcp.json`):
 ```
 
 <details>
-<summary><strong>68 MCP Tools</strong> - full tool reference</summary>
+<summary><strong>84 MCP Tools</strong> - full tool reference</summary>
 
 &nbsp;
 
@@ -164,7 +165,7 @@ Add to your Cursor MCP config (`.cursor/mcp.json`):
 | `docker_save` | Save one or more images to a tar archive |
 | `docker_load` | Load images from a tar archive |
 
-**Compose** (8)
+**Compose** (24)
 
 | Tool | What It Does |
 |---|---|
@@ -176,6 +177,22 @@ Add to your Cursor MCP config (`.cursor/mcp.json`):
 | `docker_composeRestart` | Restart Compose services |
 | `docker_composePull` | Pull images for Compose services |
 | `docker_composeExec` | Execute a command in a running Compose service container |
+| `docker_composeConfig` | Validate, resolve, and render a Compose file in canonical format |
+| `docker_composeCp` | Copy files between a Compose service container and local filesystem |
+| `docker_composeCreate` | Create service containers without starting them |
+| `docker_composeEvents` | Receive real-time events from Compose containers |
+| `docker_composeImages` | List images used by Compose service containers |
+| `docker_composeKill` | Force stop Compose service containers |
+| `docker_composeLs` | List running Compose projects |
+| `docker_composePause` | Pause Compose services |
+| `docker_composeUnpause` | Unpause Compose services |
+| `docker_composePort` | Print the public port for a Compose service port binding |
+| `docker_composeRm` | Remove stopped Compose service containers |
+| `docker_composeRun` | Run a one-off command on a Compose service |
+| `docker_composeScale` | Scale Compose services to a specified replica count |
+| `docker_composeStart` | Start existing Compose service containers |
+| `docker_composeStop` | Stop Compose services without removing containers |
+| `docker_composeTop` | Display running processes in Compose service containers |
 
 **Volume Management** (4)
 

ROADMAP.md

@@ -4,7 +4,7 @@
 
 ## Current Status
 
-**v0.7.0** - Buildx, Manifests, and Registry release with 14 skills, 8 rules, and 68 MCP tools.
+**v0.8.0** - Compose Completeness release with 14 skills, 9 rules, and 84 MCP tools.
 
 ## Release Plan
 
@@ -16,8 +16,8 @@
 | v0.4.0 | Compose | +8 | 36 | +1 | +1 | Released |
 | v0.5.0 | Volumes, Networks, Cleanup | +13 | 49 | +0 | +0 | Released |
 | v0.6.0 | Advanced and Observability | +6 | 55 | +1 | +1 | Released |
-| v0.7.0 | Buildx, Manifests, and Registry | +13 | 68 | +1 | +1 | (current) |
-| v0.8.0 | Compose Completeness | +16 | 84 | +0 | +1 | Planned |
+| v0.7.0 | Buildx, Manifests, and Registry | +13 | 68 | +1 | +1 | Released |
+| v0.8.0 | Compose Completeness | +16 | 84 | +0 | +1 | (current) |
 | v0.9.0 | Container/Image Gaps, Context, Auth | +14 | 98 | +1 | +0 | Planned |
 | v0.10.0 | Swarm Orchestration | +24 | 122 | +1 | +1 | Planned |
 | v0.11.0 | Swarm Stacks, Configs, Secrets, Trust | +18 | 140 | +1 | +0 | Planned |
@@ -403,7 +403,8 @@ All destructive MCP tools (`rm`, `rmi`, `prune`, `kill`, `down`, `leave`) will:
 - [x] Comprehensive roadmap rewrite with ~150 planned MCP tools
 - [x] 13 buildx and manifest tools (buildxBuild/Ls/Create/Rm/Inspect/Use/Imagetools, builderPrune, manifestCreate/Inspect/Annotate/Push/Rm)
 - [x] 14 skills covering Docker workflows including multi-platform builds
-- [x] 8 rules including buildx best practices
+- [x] 16 compose completeness tools (composeConfig/Cp/Create/Events/Images/Kill/Ls/Pause/Unpause/Port/Rm/Run/Scale/Start/Stop/Top)
+- [x] 9 rules including buildx best practices and compose scaling
 - [x] 8 image and build tools (pull, push, build, tag, rmi, commit, save, load)
 - [x] 8 compose tools (composeUp, composeDown, composePs, composeLogs, composeBuild, composeRestart, composePull, composeExec)
 - [x] 13 volume, network, and cleanup tools (volumeCreate/Rm/Inspect/Prune, networkCreate/Rm/Connect/Disconnect/Inspect/Prune, systemPrune, containerPrune, imagePrune)