v0.10.0: Swarm Orchestration - 24 new MCP tools, 1 skill, 1 rule

Add 24 Swarm orchestration tools covering cluster management (init, join, leave, join-token, update, unlock, unlock-key, ca), service lifecycle (create, update, rm, ls, inspect, logs, ps, scale, rollback), and node administration (ls, inspect, ps, rm, update, promote, demote).

New docker-swarm skill for Swarm mode patterns and swarm-security rule for autolock, cert rotation, encrypted overlays, and resource limits.

Totals: 122 MCP tools, 16 skills, 10 rules.
Made-with: Cursor

Author: TMHSDigital

.cursor-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "docker-developer-tools",
   "displayName": "Docker Developer Tools",
-  "version": "0.9.0",
-  "description": "A Cursor plugin for Docker and container workflows - 15 skills, 9 rules, and 98 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.10.0",
+  "description": "A Cursor plugin for Docker and container workflows - 16 skills, 10 rules, and 122 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,42 @@ 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.10.0] - 2026-03-29
+
+### Added
+
+#### MCP Server - Swarm Orchestration (+24, total 122)
+- `docker_swarmInit` - initialize a new Docker Swarm cluster
+- `docker_swarmJoin` - join an existing Swarm as worker or manager node
+- `docker_swarmLeave` - leave the Docker Swarm
+- `docker_swarmJoinToken` - display or rotate join tokens for worker or manager nodes
+- `docker_swarmUpdate` - update Swarm configuration (task history, cert expiry, autolock)
+- `docker_swarmUnlock` - unlock a locked Swarm manager node (secure stdin key piping)
+- `docker_swarmUnlockKey` - display or rotate the Swarm unlock key
+- `docker_swarmCa` - display and rotate the cluster root CA certificate (120s timeout)
+- `docker_serviceCreate` - create a replicated or global Swarm service with ports, env, mounts, networks, constraints, and resource limits (120s timeout)
+- `docker_serviceUpdate` - rolling update of service image, replicas, env, labels, and resources (120s timeout)
+- `docker_serviceRm` - remove one or more Swarm services
+- `docker_serviceLs` - list Swarm services with optional filters (JSON format)
+- `docker_serviceInspect` - inspect detailed service configuration (pretty or JSON)
+- `docker_serviceLogs` - fetch service or task logs with tail, since, and timestamp options
+- `docker_servicePs` - list tasks of a service with filters (JSON format)
+- `docker_serviceScale` - scale one or more services to target replica count (120s timeout)
+- `docker_serviceRollback` - revert a service to its previous configuration (120s timeout)
+- `docker_nodeLs` - list nodes in the Swarm with filters (JSON format)
+- `docker_nodeInspect` - inspect detailed node information (pretty or JSON)
+- `docker_nodePs` - list tasks running on a node with filters (JSON format)
+- `docker_nodeRm` - remove one or more nodes from the Swarm
+- `docker_nodeUpdate` - update node availability (active/pause/drain), role, and labels
+- `docker_nodePromote` - promote worker nodes to manager
+- `docker_nodeDemote` - demote manager nodes to worker
+
+#### Skill
+- `docker-swarm` - Swarm mode orchestration covering cluster init, service deployment, scaling, rolling updates, node management, and drain/failover patterns
+
+#### Rule
+- `swarm-security` - flag missing autolock, unrotated certificates, unencrypted overlay networks, exposed manager ports, missing resource limits on services, join tokens in code, and missing healthchecks
+
 ## [0.9.0] - 2026-03-29
 
 ### Added
@@ -259,6 +295,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.10.0]: https://github.com/TMHSDigital/Docker-Developer-Tools/releases/tag/v0.10.0
 [0.9.0]: https://github.com/TMHSDigital/Docker-Developer-Tools/releases/tag/v0.9.0
 [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

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 15 skills, 9 rules, and a companion MCP server with 98 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 16 skills, 10 rules, and a companion MCP server with 122 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.9.0
+**Version:** 0.10.0
 **License:** CC-BY-NC-ND-4.0
 **Author:** TMHSDigital
 
@@ -35,7 +35,7 @@ Docker-Developer-Tools/
   tests/                     # Python structure tests
 ```
 
-## Skills (15)
+## Skills (16)
 
 | Skill | Description |
 |-------|-------------|
@@ -54,8 +54,9 @@ 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 |
 | `docker-context-management` | Remote Docker hosts, SSH/TLS contexts, multi-host workflows |
+| `docker-swarm` | Swarm cluster management, service deployment, scaling, node administration |
 
-## Rules (9)
+## Rules (10)
 
 | Rule | Scope | Description |
 |------|-------|-------------|
@@ -68,8 +69,9 @@ Docker-Developer-Tools/
 | `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 |
+| `swarm-security` | Docker-related files | Flag missing autolock, unrotated certs, unencrypted overlays, exposed ports |
 
-## MCP Server (98 tools)
+## MCP Server (122 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.
 
@@ -241,6 +243,45 @@ The MCP server talks to Docker via CLI exec (`docker` commands) rather than the
 | `docker_login` | Authenticate to a container registry |
 | `docker_logout` | Log out from a container registry |
 
+### Swarm Cluster (8)
+
+| Tool | Description |
+|------|-------------|
+| `docker_swarmInit` | Initialize a new Swarm cluster |
+| `docker_swarmJoin` | Join a Swarm as worker or manager |
+| `docker_swarmLeave` | Leave the Swarm |
+| `docker_swarmJoinToken` | Display or rotate join tokens |
+| `docker_swarmUpdate` | Update Swarm configuration |
+| `docker_swarmUnlock` | Unlock a locked Swarm manager |
+| `docker_swarmUnlockKey` | Display or rotate the unlock key |
+| `docker_swarmCa` | Display and rotate root CA certificate |
+
+### Swarm Services (9)
+
+| Tool | Description |
+|------|-------------|
+| `docker_serviceCreate` | Create a replicated or global service |
+| `docker_serviceUpdate` | Update a service |
+| `docker_serviceRm` | Remove services |
+| `docker_serviceLs` | List services |
+| `docker_serviceInspect` | Inspect a service |
+| `docker_serviceLogs` | Fetch service logs |
+| `docker_servicePs` | List tasks of a service |
+| `docker_serviceScale` | Scale services |
+| `docker_serviceRollback` | Rollback a service |
+
+### Swarm Nodes (7)
+
+| Tool | Description |
+|------|-------------|
+| `docker_nodeLs` | List nodes in the Swarm |
+| `docker_nodeInspect` | Inspect a node |
+| `docker_nodePs` | List tasks on a node |
+| `docker_nodeRm` | Remove nodes |
+| `docker_nodeUpdate` | Update node metadata |
+| `docker_nodePromote` | Promote workers to managers |
+| `docker_nodeDemote` | Demote managers to workers |
+
 ## Development Workflow
 
 ### Plugin development (symlink)
@@ -408,3 +449,27 @@ Full checklist with copy-paste commands: [CONTRIBUTING.md - Release Checklist](C
 | `docker context show` | `docker_contextShow` |
 | `docker login --password-stdin` | `docker_login` |
 | `docker logout` | `docker_logout` |
+| `docker swarm init` | `docker_swarmInit` |
+| `docker swarm join` | `docker_swarmJoin` |
+| `docker swarm leave` | `docker_swarmLeave` |
+| `docker swarm join-token` | `docker_swarmJoinToken` |
+| `docker swarm update` | `docker_swarmUpdate` |
+| `docker swarm unlock` | `docker_swarmUnlock` |
+| `docker swarm unlock-key` | `docker_swarmUnlockKey` |
+| `docker swarm ca` | `docker_swarmCa` |
+| `docker service create` | `docker_serviceCreate` |
+| `docker service update` | `docker_serviceUpdate` |
+| `docker service rm` | `docker_serviceRm` |
+| `docker service ls --format json` | `docker_serviceLs` |
+| `docker service inspect` | `docker_serviceInspect` |
+| `docker service logs` | `docker_serviceLogs` |
+| `docker service ps --format json` | `docker_servicePs` |
+| `docker service scale` | `docker_serviceScale` |
+| `docker service rollback` | `docker_serviceRollback` |
+| `docker node ls --format json` | `docker_nodeLs` |
+| `docker node inspect` | `docker_nodeInspect` |
+| `docker node ps --format json` | `docker_nodePs` |
+| `docker node rm` | `docker_nodeRm` |
+| `docker node update` | `docker_nodeUpdate` |
+| `docker node promote` | `docker_nodePromote` |
+| `docker node demote` | `docker_nodeDemote` |

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.9.0-green" alt="Version" />
+  <img src="https://img.shields.io/badge/version-0.10.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>15 skills</strong>&nbsp;&bull;&nbsp;<strong>9 rules</strong>&nbsp;&bull;&nbsp;<strong>98 MCP tools</strong>
+  <strong>16 skills</strong>&nbsp;&bull;&nbsp;<strong>10 rules</strong>&nbsp;&bull;&nbsp;<strong>122 MCP tools</strong>
 </p>
 
 ---
@@ -71,6 +71,7 @@ flowchart LR
 | **Advanced** | `docker-advanced-workflows` | Multi-stage pipelines, sidecar patterns, healthchecks, signal handling |
 | **Advanced** | `docker-multi-platform` | Multi-arch builds, buildx configuration, manifest lists, platform targeting |
 | **Advanced** | `docker-context-management` | Remote Docker hosts, SSH/TLS contexts, multi-host workflows |
+| **Orchestration** | `docker-swarm` | Swarm cluster management, service deployment, scaling, node administration |
 
 </details>
 
@@ -90,6 +91,7 @@ flowchart LR
 | `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 |
+| `swarm-security` | Docker-related files | Flag missing autolock, unrotated certs, unencrypted overlays, exposed ports |
 
 </details>
 
@@ -291,6 +293,45 @@ Add to your Cursor MCP config (`.cursor/mcp.json`):
 | `docker_login` | Authenticate to a Docker container registry |
 | `docker_logout` | Log out from a Docker container registry |
 
+**Swarm Cluster** (8)
+
+| Tool | What It Does |
+|---|---|
+| `docker_swarmInit` | Initialize a new Docker Swarm cluster |
+| `docker_swarmJoin` | Join an existing Swarm as worker or manager |
+| `docker_swarmLeave` | Leave the Docker Swarm |
+| `docker_swarmJoinToken` | Display or rotate join tokens |
+| `docker_swarmUpdate` | Update Swarm configuration |
+| `docker_swarmUnlock` | Unlock a locked Swarm manager |
+| `docker_swarmUnlockKey` | Display or rotate the unlock key |
+| `docker_swarmCa` | Display and rotate the root CA certificate |
+
+**Swarm Services** (9)
+
+| Tool | What It Does |
+|---|---|
+| `docker_serviceCreate` | Create a replicated or global Swarm service |
+| `docker_serviceUpdate` | Update a service (image, replicas, env, resources) |
+| `docker_serviceRm` | Remove Swarm services |
+| `docker_serviceLs` | List Swarm services |
+| `docker_serviceInspect` | Inspect detailed service configuration |
+| `docker_serviceLogs` | Fetch service or task logs |
+| `docker_servicePs` | List tasks of a service |
+| `docker_serviceScale` | Scale services to target replica count |
+| `docker_serviceRollback` | Revert a service to its previous version |
+
+**Swarm Nodes** (7)
+
+| Tool | What It Does |
+|---|---|
+| `docker_nodeLs` | List nodes in the Swarm |
+| `docker_nodeInspect` | Inspect detailed node information |
+| `docker_nodePs` | List tasks running on a node |
+| `docker_nodeRm` | Remove nodes from the Swarm |
+| `docker_nodeUpdate` | Update node availability, role, or labels |
+| `docker_nodePromote` | Promote workers to managers |
+| `docker_nodeDemote` | Demote managers to workers |
+
 </details>
 
 ---
@@ -350,6 +391,7 @@ Then add the JSON config from the [MCP Server section](#companion-docker-mcp-ser
 | `docker-advanced-workflows` | "Set up healthchecks and graceful shutdown for my Node.js container" |
 | `docker-multi-platform` | "Build my Go API image for both amd64 and arm64 with buildx" |
 | `docker-context-management` | "Set up a Docker context for my remote staging server via SSH" |
+| `docker-swarm` | "Initialize a Swarm cluster and deploy a 3-replica nginx service" |
 
 </details>
 

ROADMAP.md

@@ -4,7 +4,7 @@
 
 ## Current Status
 
-**v0.9.0** - Container/Image Gaps, Context, and Auth release with 15 skills, 9 rules, and 98 MCP tools.
+**v0.10.0** - Swarm Orchestration release with 16 skills, 10 rules, and 122 MCP tools.
 
 ## Release Plan
 
@@ -18,8 +18,8 @@
 | v0.6.0 | Advanced and Observability | +6 | 55 | +1 | +1 | Released |
 | v0.7.0 | Buildx, Manifests, and Registry | +13 | 68 | +1 | +1 | Released |
 | v0.8.0 | Compose Completeness | +16 | 84 | +0 | +1 | Released |
-| v0.9.0 | Container/Image Gaps, Context, Auth | +14 | 98 | +1 | +0 | (current) |
-| v0.10.0 | Swarm Orchestration | +24 | 122 | +1 | +1 | Planned |
+| v0.9.0 | Container/Image Gaps, Context, Auth | +14 | 98 | +1 | +0 | Released |
+| v0.10.0 | Swarm Orchestration | +24 | 122 | +1 | +1 | (current) |
 | v0.11.0 | Swarm Stacks, Configs, Secrets, Trust | +18 | 140 | +1 | +0 | Planned |
 | v0.12.0 | Niche, Scout, and Extras | +10 | 150 | +0 | +0 | Planned |
 | v1.0.0 | Stable | +0 | 150 | +0 | +0 | Planned |