Skip to content

Commit 35de3e5

Browse files
committed
v0.12.0: Niche, Scout, and Extras - 10 new MCP tools
Utility: docker_version, docker_composeVersion Compose extras: docker_composeWatch Docker Scout: docker_scoutQuickview, docker_scoutCves, docker_scoutRecommendations Plugin management: docker_pluginLs, docker_pluginInstall, docker_pluginRm, docker_pluginEnable Total: 150 MCP tools, 17 skills, 10 rules Made-with: Cursor
1 parent f7ced5e commit 35de3e5

20 files changed

+588
-22
lines changed

.cursor-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
{
22
"name": "docker-developer-tools",
33
"displayName": "Docker Developer Tools",
4-
"version": "0.11.0",
5-
"description": "A Cursor plugin for Docker and container workflows - 17 skills, 10 rules, and 140 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.",
4+
"version": "0.12.0",
5+
"description": "A Cursor plugin for Docker and container workflows - 17 skills, 10 rules, and 150 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.",
66
"author": {
77
"name": "TMHSDigital",
88
"url": "https://github.com/TMHSDigital"

CHANGELOG.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.12.0] - 2026-03-29
9+
10+
### Added
11+
12+
#### MCP Server - Niche, Scout, and Extras (+10, total 150)
13+
- `docker_version` - show Docker client and server version information (JSON format)
14+
- `docker_composeVersion` - show Docker Compose version information (JSON format)
15+
- `docker_composeWatch` - watch build context for Compose services and auto-rebuild on file changes (120s timeout)
16+
- `docker_scoutQuickview` - quick overview of image vulnerabilities using Docker Scout (requires Docker Desktop, 120s timeout)
17+
- `docker_scoutCves` - list CVEs found in an image with optional severity and only-fixed filters (120s timeout)
18+
- `docker_scoutRecommendations` - get base image update recommendations using Docker Scout (120s timeout)
19+
- `docker_pluginLs` - list installed Docker plugins (JSON format)
20+
- `docker_pluginInstall` - install a Docker plugin from a registry (grant-all-permissions, alias, 120s timeout)
21+
- `docker_pluginRm` - remove one or more Docker plugins (force option)
22+
- `docker_pluginEnable` - enable a disabled Docker plugin
23+
24+
---
25+
826
## [0.11.0] - 2026-03-29
927

1028
### Added

CLAUDE.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ Project documentation for Claude Code and AI assistants working on this reposito
44

55
## Project Overview
66

7-
Docker Developer Tools is a Cursor IDE plugin that integrates Docker and container workflows into Cursor's AI chat. It includes 17 skills, 10 rules, and a companion MCP server with 140 tools for live Docker CLI integration.
7+
Docker Developer Tools is a Cursor IDE plugin that integrates Docker and container workflows into Cursor's AI chat. It includes 17 skills, 10 rules, and a companion MCP server with 150 tools for live Docker CLI integration.
88

99
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.
1010

11-
**Version:** 0.11.0
11+
**Version:** 0.12.0
1212
**License:** CC-BY-NC-ND-4.0
1313
**Author:** TMHSDigital
1414

@@ -72,7 +72,7 @@ Docker-Developer-Tools/
7272
| `compose-scaling` | Compose files | Flag scaling blockers: container_name, fixed host ports, missing limits |
7373
| `swarm-security` | Docker-related files | Flag missing autolock, unrotated certs, unencrypted overlays, exposed ports |
7474

75-
## MCP Server (140 tools)
75+
## MCP Server (150 tools)
7676

7777
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.
7878

@@ -530,3 +530,13 @@ Full checklist with copy-paste commands: [CONTRIBUTING.md - Release Checklist](C
530530
| `docker trust sign` | `docker_trustSign` |
531531
| `docker trust revoke` | `docker_trustRevoke` |
532532
| `docker trust key` | `docker_trustKey` |
533+
| `docker version --format json` | `docker_version` |
534+
| `docker compose version --format json` | `docker_composeVersion` |
535+
| `docker compose watch` | `docker_composeWatch` |
536+
| `docker scout quickview` | `docker_scoutQuickview` |
537+
| `docker scout cves` | `docker_scoutCves` |
538+
| `docker scout recommendations` | `docker_scoutRecommendations` |
539+
| `docker plugin ls --format json` | `docker_pluginLs` |
540+
| `docker plugin install` | `docker_pluginInstall` |
541+
| `docker plugin rm` | `docker_pluginRm` |
542+
| `docker plugin enable` | `docker_pluginEnable` |

README.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
<p align="center">
1212
<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>
1313
<a href="LICENSE"><img src="https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-blue" alt="License" /></a>
14-
<img src="https://img.shields.io/badge/version-0.11.0-green" alt="Version" />
14+
<img src="https://img.shields.io/badge/version-0.12.0-green" alt="Version" />
1515
<a href="https://www.npmjs.com/package/@tmhs/docker-mcp"><img src="https://img.shields.io/npm/v/@tmhs/docker-mcp" alt="npm" /></a>
1616
<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>
1717
<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 @@
2222
</p>
2323

2424
<p align="center">
25-
<strong>17 skills</strong>&nbsp;&bull;&nbsp;<strong>10 rules</strong>&nbsp;&bull;&nbsp;<strong>140 MCP tools</strong>
25+
<strong>17 skills</strong>&nbsp;&bull;&nbsp;<strong>10 rules</strong>&nbsp;&bull;&nbsp;<strong>150 MCP tools</strong>
2626
</p>
2727

2828
---
@@ -122,7 +122,7 @@ Add to your Cursor MCP config (`.cursor/mcp.json`):
122122
```
123123

124124
<details>
125-
<summary><strong>98 MCP Tools</strong> - full tool reference</summary>
125+
<summary><strong>150 MCP Tools</strong> - full tool reference</summary>
126126

127127
&nbsp;
128128

@@ -371,6 +371,36 @@ Add to your Cursor MCP config (`.cursor/mcp.json`):
371371
| `docker_trustRevoke` | Revoke trust for an image |
372372
| `docker_trustKey` | Manage signing keys (generate or load) |
373373

374+
**Utility** (2)
375+
376+
| Tool | What It Does |
377+
|---|---|
378+
| `docker_version` | Show Docker client and server version information |
379+
| `docker_composeVersion` | Show Docker Compose version information |
380+
381+
**Compose Extras** (1)
382+
383+
| Tool | What It Does |
384+
|---|---|
385+
| `docker_composeWatch` | Watch build context and auto-rebuild on file changes |
386+
387+
**Docker Scout** (3)
388+
389+
| Tool | What It Does |
390+
|---|---|
391+
| `docker_scoutQuickview` | Quick overview of image vulnerabilities |
392+
| `docker_scoutCves` | List CVEs found in an image with severity filters |
393+
| `docker_scoutRecommendations` | Get base image update recommendations |
394+
395+
**Plugin Management** (4)
396+
397+
| Tool | What It Does |
398+
|---|---|
399+
| `docker_pluginLs` | List installed Docker plugins |
400+
| `docker_pluginInstall` | Install a Docker plugin from a registry |
401+
| `docker_pluginRm` | Remove one or more Docker plugins |
402+
| `docker_pluginEnable` | Enable a disabled Docker plugin |
403+
374404
</details>
375405

376406
---

ROADMAP.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
55
## Current Status
66

7-
**v0.11.0** - Swarm Stacks, Configs, Secrets, and Trust release with 17 skills, 10 rules, and 140 MCP tools.
7+
**v0.12.0** - Niche, Scout, and Extras release with 17 skills, 10 rules, and 150 MCP tools.
88

99
## Release Plan
1010

@@ -20,8 +20,8 @@
2020
| v0.8.0 | Compose Completeness | +16 | 84 | +0 | +1 | Released |
2121
| v0.9.0 | Container/Image Gaps, Context, Auth | +14 | 98 | +1 | +0 | Released |
2222
| v0.10.0 | Swarm Orchestration | +24 | 122 | +1 | +1 | Released |
23-
| v0.11.0 | Swarm Stacks, Configs, Secrets, Trust | +18 | 140 | +1 | +0 | (current) |
24-
| v0.12.0 | Niche, Scout, and Extras | +10 | 150 | +0 | +0 | Planned |
23+
| v0.11.0 | Swarm Stacks, Configs, Secrets, Trust | +18 | 140 | +1 | +0 | Released |
24+
| v0.12.0 | Niche, Scout, and Extras | +10 | 150 | +0 | +0 | (current) |
2525
| v1.0.0 | Stable | +0 | 150 | +0 | +0 | Planned |
2626

2727
---
@@ -420,6 +420,11 @@ All destructive MCP tools (`rm`, `rmi`, `prune`, `kill`, `down`, `leave`) will:
420420
- [x] GitHub Actions CI/CD workflows
421421
- [x] GitHub Pages landing site
422422
- [x] Contributing guide and issue templates
423+
- [x] 24 Swarm orchestration tools (swarmInit/Join/Leave/JoinToken/Update/Unlock/UnlockKey/Ca, serviceCreate/Update/Rm/Ls/Inspect/Logs/Ps/Scale/Rollback, nodeLs/Inspect/Ps/Rm/Update/Promote/Demote)
424+
- [x] 18 Swarm stack, config, secret, and trust tools (stackDeploy/Rm/Ls/Ps/Services/Config, configCreate/Inspect/Ls/Rm, secretCreate/Inspect/Ls/Rm, trustInspect/Sign/Revoke/Key)
425+
- [x] 10 niche/scout/extras tools (version, composeVersion, composeWatch, scoutQuickview/Cves/Recommendations, pluginLs/Install/Rm/Enable)
426+
- [x] 17 skills covering all Docker workflows
427+
- [x] 10 rules for Docker validation
423428

424429
---
425430

docs/index.html

Lines changed: 41 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
66
<title>Docker Developer Tools - Cursor Plugin</title>
7-
<meta name="description" content="Expert Docker workflows inside Cursor IDE. 17 skills, 10 rules, 140 MCP tools.">
7+
<meta name="description" content="Expert Docker workflows inside Cursor IDE. 17 skills, 10 rules, 150 MCP tools.">
88
<meta name="theme-color" content="#0db7ed">
99
<meta property="og:type" content="website">
1010
<meta property="og:title" content="Docker Developer Tools - Cursor Plugin">
11-
<meta property="og:description" content="Expert Docker workflows inside Cursor IDE. 17 skills, 10 rules, 140 MCP tools.">
11+
<meta property="og:description" content="Expert Docker workflows inside Cursor IDE. 17 skills, 10 rules, 150 MCP tools.">
1212
<meta property="og:image" content="docs/assets/og-card.jpg">
1313
<meta property="og:url" content="https://tmhsdigital.github.io/Docker-Developer-Tools/">
1414
<link rel="preconnect" href="https://fonts.googleapis.com">
@@ -241,7 +241,7 @@
241241
<h1><span>Docker</span> Developer Tools</h1>
242242
<p class="tagline">Expert Docker workflows, live container data, and real-time linting - all inside Cursor IDE.</p>
243243
<div class="pills">
244-
<span class="pill blue">v0.11.0</span>
244+
<span class="pill blue">v0.12.0</span>
245245
<span class="pill">CC BY-NC-ND 4.0</span>
246246
<span class="pill">Cursor Plugin</span>
247247
</div>
@@ -497,7 +497,7 @@ <h3><span class="rule-icon">&#9878;</span> compose-scaling</h3>
497497
<!-- MCP TOOLS TABLE -->
498498
<section id="mcp-tools">
499499
<div class="container">
500-
<h2 class="section-title reveal">140 MCP Tools</h2>
500+
<h2 class="section-title reveal">150 MCP Tools</h2>
501501
<p class="section-subtitle reveal">Live Docker data, container lifecycle, image pipeline, complete Compose V2, volume/network CRUD, resource cleanup, buildx, manifests, context management, and registry authentication via the companion MCP server.</p>
502502
<div class="tools-table-wrap reveal">
503503
<table class="tools-table">
@@ -716,6 +716,40 @@ <h3>Docker Content Trust <span class="tool-count">4 tools</span></h3>
716716
<tr><td class="tool-name">docker_trustKey</td><td>Manage signing keys</td></tr>
717717
</tbody>
718718
</table>
719+
<h3 class="tool-category">Utility (2)</h3>
720+
<table>
721+
<thead><tr><th>Tool</th><th>Description</th></tr></thead>
722+
<tbody>
723+
<tr><td class="tool-name">docker_version</td><td>Show Docker client and server version info</td></tr>
724+
<tr><td class="tool-name">docker_composeVersion</td><td>Show Docker Compose version info</td></tr>
725+
</tbody>
726+
</table>
727+
<h3 class="tool-category">Compose Extras (1)</h3>
728+
<table>
729+
<thead><tr><th>Tool</th><th>Description</th></tr></thead>
730+
<tbody>
731+
<tr><td class="tool-name">docker_composeWatch</td><td>Watch build context and auto-rebuild on file changes</td></tr>
732+
</tbody>
733+
</table>
734+
<h3 class="tool-category">Docker Scout (3)</h3>
735+
<table>
736+
<thead><tr><th>Tool</th><th>Description</th></tr></thead>
737+
<tbody>
738+
<tr><td class="tool-name">docker_scoutQuickview</td><td>Quick overview of image vulnerabilities</td></tr>
739+
<tr><td class="tool-name">docker_scoutCves</td><td>List CVEs found in an image</td></tr>
740+
<tr><td class="tool-name">docker_scoutRecommendations</td><td>Get base image update recommendations</td></tr>
741+
</tbody>
742+
</table>
743+
<h3 class="tool-category">Plugin Management (4)</h3>
744+
<table>
745+
<thead><tr><th>Tool</th><th>Description</th></tr></thead>
746+
<tbody>
747+
<tr><td class="tool-name">docker_pluginLs</td><td>List installed Docker plugins</td></tr>
748+
<tr><td class="tool-name">docker_pluginInstall</td><td>Install a Docker plugin from a registry</td></tr>
749+
<tr><td class="tool-name">docker_pluginRm</td><td>Remove one or more Docker plugins</td></tr>
750+
<tr><td class="tool-name">docker_pluginEnable</td><td>Enable a disabled Docker plugin</td></tr>
751+
</tbody>
752+
</table>
719753
</div>
720754
</div>
721755
</section>
@@ -878,20 +912,20 @@ <h3>v0.10.0 <span class="tag upcoming-tag">Released</span></h3>
878912

879913
<div class="timeline-item">
880914
<div class="timeline-dot"></div>
881-
<h3>v0.11.0 <span class="tag current-tag">Current</span></h3>
915+
<h3>v0.11.0</h3>
882916
<p>Swarm Stacks, Configs, Secrets, Trust - 18 tools: stack deploy, config/secret CRUD, Docker Content Trust.</p>
883917
</div>
884918

885919
<div class="timeline-item">
886920
<div class="timeline-dot"></div>
887-
<h3>v0.12.0 <span class="tag upcoming-tag">Planned</span></h3>
921+
<h3>v0.12.0 <span class="tag current-tag">Current</span></h3>
888922
<p>Niche, Scout, Extras - 10 tools: version info, Scout CVEs/recommendations, compose watch, plugin management.</p>
889923
</div>
890924

891925
<div class="timeline-item">
892926
<div class="timeline-dot"></div>
893927
<h3>v1.0.0 <span class="tag upcoming-tag">Planned</span></h3>
894-
<p>Stable release - finalized APIs, full test coverage, comprehensive docs, ~150 MCP tools.</p>
928+
<p>Stable release - finalized APIs, full test coverage, comprehensive docs, 150 MCP tools.</p>
895929
</div>
896930

897931
</div>

mcp-server/README.md

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# @tmhs/docker-mcp
22

3-
MCP server for Docker CLI integration - 140 tools for containers, images, complete Compose V2, volumes, networks, cleanup, observability, buildx, manifests, contexts, registry auth, Swarm orchestration, stacks, configs, secrets, content trust, and system info.
3+
MCP server for Docker CLI integration - 150 tools for containers, images, complete Compose V2, volumes, networks, cleanup, observability, buildx, manifests, contexts, registry auth, Swarm orchestration, stacks, configs, secrets, content trust, Scout, plugins, and system info.
44

55
Part of the [Docker Developer Tools](https://github.com/TMHSDigital/Docker-Developer-Tools) Cursor plugin.
66

@@ -295,6 +295,36 @@ Or if installed globally:
295295
| `docker_trustRevoke` | Revoke trust for an image |
296296
| `docker_trustKey` | Manage signing keys |
297297

298+
### Utility (2)
299+
300+
| Tool | Description |
301+
|------|-------------|
302+
| `docker_version` | Show Docker client and server version information |
303+
| `docker_composeVersion` | Show Docker Compose version information |
304+
305+
### Compose Extras (1)
306+
307+
| Tool | Description |
308+
|------|-------------|
309+
| `docker_composeWatch` | Watch build context and auto-rebuild on file changes |
310+
311+
### Docker Scout (3)
312+
313+
| Tool | Description |
314+
|------|-------------|
315+
| `docker_scoutQuickview` | Quick overview of image vulnerabilities |
316+
| `docker_scoutCves` | List CVEs found in an image |
317+
| `docker_scoutRecommendations` | Get base image update recommendations |
318+
319+
### Plugin Management (4)
320+
321+
| Tool | Description |
322+
|------|-------------|
323+
| `docker_pluginLs` | List installed Docker plugins |
324+
| `docker_pluginInstall` | Install a Docker plugin from a registry |
325+
| `docker_pluginRm` | Remove one or more Docker plugins |
326+
| `docker_pluginEnable` | Enable a disabled Docker plugin |
327+
298328
## License
299329

300330
CC-BY-NC-ND-4.0 - Copyright 2026 TM Hospitality Strategies

mcp-server/package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "@tmhs/docker-mcp",
3-
"version": "0.11.0",
4-
"description": "MCP server for Docker CLI integration - 140 tools for containers, images, compose, volumes, networks, cleanup, observability, buildx, manifests, contexts, registry auth, Swarm orchestration, stacks, configs, secrets, content trust, and system info.",
3+
"version": "0.12.0",
4+
"description": "MCP server for Docker CLI integration - 150 tools for containers, images, compose, volumes, networks, cleanup, observability, buildx, manifests, contexts, registry auth, Swarm orchestration, stacks, configs, secrets, content trust, Scout, plugins, and system info.",
55
"type": "module",
66
"main": "dist/index.js",
77
"bin": {

mcp-server/src/index.ts

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,10 +143,20 @@ import { register as registerTrustInspect } from "./tools/trustInspect.js";
143143
import { register as registerTrustSign } from "./tools/trustSign.js";
144144
import { register as registerTrustRevoke } from "./tools/trustRevoke.js";
145145
import { register as registerTrustKey } from "./tools/trustKey.js";
146+
import { register as registerVersion } from "./tools/version.js";
147+
import { register as registerComposeVersion } from "./tools/composeVersion.js";
148+
import { register as registerComposeWatch } from "./tools/composeWatch.js";
149+
import { register as registerScoutQuickview } from "./tools/scoutQuickview.js";
150+
import { register as registerScoutCves } from "./tools/scoutCves.js";
151+
import { register as registerScoutRecommendations } from "./tools/scoutRecommendations.js";
152+
import { register as registerPluginLs } from "./tools/pluginLs.js";
153+
import { register as registerPluginInstall } from "./tools/pluginInstall.js";
154+
import { register as registerPluginRm } from "./tools/pluginRm.js";
155+
import { register as registerPluginEnable } from "./tools/pluginEnable.js";
146156

147157
const server = new McpServer({
148158
name: "docker-mcp",
149-
version: "0.11.0",
159+
version: "0.12.0",
150160
});
151161

152162
registerListContainers(server);
@@ -289,6 +299,16 @@ registerTrustInspect(server);
289299
registerTrustSign(server);
290300
registerTrustRevoke(server);
291301
registerTrustKey(server);
302+
registerVersion(server);
303+
registerComposeVersion(server);
304+
registerComposeWatch(server);
305+
registerScoutQuickview(server);
306+
registerScoutCves(server);
307+
registerScoutRecommendations(server);
308+
registerPluginLs(server);
309+
registerPluginInstall(server);
310+
registerPluginRm(server);
311+
registerPluginEnable(server);
292312

293313
async function main(): Promise<void> {
294314
const transport = new StdioServerTransport();

0 commit comments

Comments
 (0)