Features Rules MCP Tools Install Roadmap GitHub

Docker Developer Tools

Expert Docker workflows, live container data, and real-time linting - for Cursor, Claude Code, and any MCP client.

v1.0.0 CC BY-NC-ND 4.0 Cursor Claude Code MCP
Get Started View on GitHub

0
Skills
0
Rules
0
MCP Tools

Who Is This For

Built for developers who ship with containers every day.

Backend Developers

Get Dockerfile best practices, multi-stage build guidance, and image optimization tips without leaving your editor. Debug container issues in seconds.

DevOps Engineers

Compose validation, CI/CD pipeline templates, registry workflows, and security hardening - all context-aware and tuned to your running environment.

Full-Stack Developers

Spin up development environments, manage volumes and networks, and troubleshoot port conflicts without memorizing Docker CLI flags.


How It Works

Three steps from question to answer.

1

Ask a Docker Question

Type your question in Cursor or Claude Code - anything from Dockerfile syntax to debugging a crashing container.

2

Cursor Loads a Skill

The plugin matches your query to one of 17 specialized skills, each loaded with Docker best practices and structured guidance.

3

MCP Tools Fetch Live Data

The companion MCP server queries your local Docker engine in real time - containers, images, logs, networks, and more.

See It In Action

Real-time Docker debugging, right in your chat.

Cursor AI Chat
You: My container keeps restarting with exit code 137
Agent (container-debugging skill):
Exit code 137 means the process was killed by SIGKILL (signal 9). This is almost always an Out-Of-Memory (OOM) kill - the container exceeded its memory limit and the kernel terminated it.
docker_inspectContainer({ "containerId": "webapp-prod" })
Confirmed: OOMKilled: true, memory limit is set to 256MB but the process peaked at 312MB.
Recommendation: Increase the memory limit or optimize the application's memory usage.

docker run --memory=512m --memory-swap=512m webapp:latest

17 Skills, Organized

Each skill is a focused knowledge module loaded on demand.

dockerfile-best-practices docker-compose-helper docker-troubleshooting
image-optimization docker-resource-management
docker-networking docker-volumes
docker-security docker-image-signing
docker-ci-cd docker-registry docker-development-env docker-context-management
container-debugging
docker-advanced-workflows docker-multi-platform
docker-swarm

10 Always-On Rules

Automatic linting and guardrails that catch issues before they ship.

dockerfile-lint

**/Dockerfile*

Flags Dockerfile antipatterns like running as root, missing health checks, and inefficient layer ordering.

docker-secrets

Global (always active)

Detects hardcoded passwords, API keys, and tokens. Recommends environment variables or Docker secrets.

compose-validation

**/docker-compose*.yml

Validates compose file structure, service dependencies, and network configurations.

docker-resource-limits

Docker-related files

Flags missing CPU and memory limits that could lead to resource exhaustion in production.

docker-image-pinning

Dockerfiles, compose files

Catches unpinned image tags like :latest that create non-reproducible builds.

docker-port-conflicts

Dockerfiles, compose files

Detects duplicate port mappings and common port conflicts across services.

docker-logging

Dockerfiles, compose files

Flags missing logging drivers and log rotation settings that can fill disks.

buildx-best-practices

Dockerfiles, compose files

Flags multi-platform build issues, missing cache configuration, and architecture-specific hardcoding.

compose-scaling

**/docker-compose*.yml

Flags scaling blockers: container_name, fixed host ports, missing resource limits, missing restart policy.

swarm-security

Docker-related files

Flags missing autolock, unrotated certificates, unencrypted overlay networks, and exposed management ports.

150 MCP Tools

Live Docker data, container lifecycle, image pipeline, complete Compose V2, volume/network CRUD, resource cleanup, buildx, manifests, context management, Swarm orchestration, and more via the companion MCP server.

/
ToolDescription
docker_listContainersList running or all containers with status, ports, and names
docker_inspectContainerDetailed container info - config, state, mounts, networking
docker_containerLogsFetch recent container logs with tail and timestamp options
docker_listImagesList local images with tags, sizes, and creation dates
docker_inspectImageFull image metadata - layers, environment, entrypoint, labels
docker_listVolumesList Docker volumes with driver and mount point info
docker_listNetworksList networks with driver, scope, and connected containers
docker_systemInfoDocker engine info - version, OS, storage driver, resource totals
docker_diskUsageDisk usage breakdown by images, containers, volumes, and build cache
docker_searchHubSearch Docker Hub for images by keyword
Container Lifecycle
docker_runCreate and start a container from an image (ports, env, volumes, network)
docker_createCreate a container without starting it
docker_startStart a stopped container
docker_stopStop a running container with optional grace period
docker_restartRestart a container with optional grace period
docker_killSend a signal to a running container (default: SIGKILL)
docker_rmRemove a container (with optional force and volume removal)
docker_pausePause all processes in a running container
docker_unpauseUnpause a paused container
docker_execExecute a command in a running container
Image and Build
docker_pullPull an image or repository from a registry
docker_pushPush an image or repository to a registry
docker_buildBuild an image from a Dockerfile and context directory
docker_tagCreate a tag that refers to a source image
docker_rmiRemove one or more images
docker_commitCreate a new image from a container's changes
docker_saveSave one or more images to a tar archive
docker_loadLoad images from a tar archive
Compose
docker_composeUpCreate and start Compose services (detached, build, profiles)
docker_composeDownStop and remove containers, networks, volumes, and images
docker_composePsList containers for a Compose project
docker_composeLogsView logs for Compose services
docker_composeBuildBuild or rebuild Compose service images
docker_composeRestartRestart Compose services
docker_composePullPull images for Compose services
docker_composeExecExecute a command in a running Compose service container
docker_composeConfigValidate, resolve, and render a Compose file
docker_composeCpCopy files to/from a Compose service container
docker_composeCreateCreate service containers without starting
docker_composeEventsReal-time events from Compose containers
docker_composeImagesList images used by Compose services
docker_composeKillForce stop Compose service containers
docker_composeLsList running Compose projects
docker_composePausePause Compose services
docker_composeUnpauseUnpause Compose services
docker_composePortPrint public port for a service binding
docker_composeRmRemove stopped Compose service containers
docker_composeRunRun one-off command on a Compose service
docker_composeScaleScale Compose services to a replica count
docker_composeStartStart existing Compose service containers
docker_composeStopStop Compose services without removing
docker_composeTopRunning processes in Compose service containers
Volume Management
docker_volumeCreateCreate a named volume with optional driver and labels
docker_volumeRmRemove one or more volumes
docker_volumeInspectDisplay detailed volume information
docker_volumePruneRemove all unused volumes
Network Management
docker_networkCreateCreate a network (bridge, overlay, macvlan)
docker_networkRmRemove one or more networks
docker_networkConnectConnect a container to a network
docker_networkDisconnectDisconnect a container from a network
docker_networkInspectDisplay detailed network information
docker_networkPruneRemove all unused networks
Cleanup / Prune
docker_systemPruneRemove unused containers, networks, images, and optionally volumes
docker_containerPruneRemove all stopped containers
docker_imagePruneRemove dangling or unused images
Advanced / Observability
docker_cpCopy files or directories between container and host
docker_statsLive resource usage statistics (CPU, memory, network I/O)
docker_topShow running processes in a container
docker_eventsReal-time events from the Docker daemon
docker_updateUpdate container resource config (CPU, memory, restart policy)
docker_waitBlock until container stops and return exit code
Buildx
docker_buildxBuildMulti-platform builds with cache export, provenance, and push/load
docker_buildxLsList buildx builder instances
docker_buildxCreateCreate a new buildx builder instance
docker_buildxRmRemove a buildx builder instance
docker_buildxInspectInspect a buildx builder instance
docker_buildxUseSet the default buildx builder
docker_buildxImagetoolsInspect or create multi-platform manifest lists via buildx
docker_builderPruneRemove buildx build cache
Manifest
docker_manifestCreateCreate a local manifest list for multi-arch images
docker_manifestInspectDisplay an image manifest or manifest list
docker_manifestAnnotateAdd platform info to a manifest list entry
docker_manifestPushPush a manifest list to a registry
docker_manifestRmRemove local manifest lists
Container Gaps
docker_diffInspect filesystem changes in a container
docker_exportExport a container's filesystem as a tar archive
docker_portList port mappings for a container
docker_renameRename a Docker container
Image Gaps
docker_imageHistoryShow layer history of an image
docker_importImport a tarball to create a filesystem image
Context Management
docker_contextCreateCreate a context for remote Docker hosts
docker_contextLsList available Docker contexts
docker_contextInspectDetailed context information
docker_contextRmRemove Docker contexts
docker_contextUseSet the active Docker context
docker_contextShowPrint current context name
Registry Authentication
docker_loginAuthenticate to a container registry
docker_logoutLog out from a container registry

Swarm Cluster 8 tools

ToolDescription
docker_swarmInitInitialize a new Swarm cluster
docker_swarmJoinJoin a Swarm as worker or manager
docker_swarmLeaveLeave the Swarm
docker_swarmJoinTokenDisplay or rotate join tokens
docker_swarmUpdateUpdate Swarm configuration
docker_swarmUnlockUnlock a locked Swarm manager
docker_swarmUnlockKeyDisplay or rotate the unlock key
docker_swarmCaDisplay and rotate root CA certificate

Swarm Services 9 tools

ToolDescription
docker_serviceCreateCreate a replicated or global service
docker_serviceUpdateUpdate a service
docker_serviceRmRemove services
docker_serviceLsList services
docker_serviceInspectInspect a service
docker_serviceLogsFetch service logs
docker_servicePsList tasks of a service
docker_serviceScaleScale services
docker_serviceRollbackRollback a service

Swarm Nodes 7 tools

ToolDescription
docker_nodeLsList nodes in the Swarm
docker_nodeInspectInspect a node
docker_nodePsList tasks on a node
docker_nodeRmRemove nodes
docker_nodeUpdateUpdate node metadata
docker_nodePromotePromote workers to managers
docker_nodeDemoteDemote managers to workers

Swarm Stacks 6 tools

ToolDescription
docker_stackDeployDeploy or update a stack
docker_stackRmRemove stacks
docker_stackLsList stacks
docker_stackPsList tasks in a stack
docker_stackServicesList services in a stack
docker_stackConfigOutput merged stack config

Swarm Configs 4 tools

ToolDescription
docker_configCreateCreate a Swarm config
docker_configInspectInspect a config
docker_configLsList configs
docker_configRmRemove configs

Swarm Secrets 4 tools

ToolDescription
docker_secretCreateCreate a Swarm secret
docker_secretInspectInspect a secret (metadata only)
docker_secretLsList secrets
docker_secretRmRemove secrets

Docker Content Trust 4 tools

ToolDescription
docker_trustInspectInspect trust data for an image
docker_trustSignSign an image
docker_trustRevokeRevoke trust for an image
docker_trustKeyManage signing keys

Utility 2 tools

ToolDescription
docker_versionShow Docker client and server version info
docker_composeVersionShow Docker Compose version info

Compose Extras 1 tool

ToolDescription
docker_composeWatchWatch build context and auto-rebuild on file changes

Docker Scout 3 tools

ToolDescription
docker_scoutQuickviewQuick overview of image vulnerabilities
docker_scoutCvesList CVEs found in an image
docker_scoutRecommendationsGet base image update recommendations

Plugin Management 4 tools

ToolDescription
docker_pluginLsList installed Docker plugins
docker_pluginInstallInstall a Docker plugin from a registry
docker_pluginRmRemove one or more Docker plugins
docker_pluginEnableEnable a disabled Docker plugin

Get Started

Up and running in under two minutes.

1

Clone the repository

git clone https://github.com/TMHSDigital/Docker-Developer-Tools.git
2

Symlink into Cursor plugins

macOS / Linux:

ln -s "$(pwd)" ~/.cursor/plugins/docker-developer-tools

Windows (PowerShell as Admin):

New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.cursor\plugins\docker-developer-tools" -Target (Get-Location)
3

Install and build the MCP server

cd mcp-server && npm install && npm run build
4

Or install globally via npm

npm install -g @tmhs/docker-mcp
5

Claude Code - register the MCP server

Claude Code reads CLAUDE.md automatically. Add the MCP server with:

claude mcp add docker node ./mcp-server/dist/index.js

Or via the global npm package:

claude mcp add docker -- npx @tmhs/docker-mcp

Try It

Paste any of these into your AI chat to see it in action.

Write a multi-stage Dockerfile for my Node.js API with a production build
Why is my docker-compose networking not working between services?
Audit my Dockerfile for security issues
How can I reduce my Docker image from 1.2GB to under 200MB?
List all running containers and show which ones are using the most memory
Set up a development environment with PostgreSQL, Redis, and my app in compose

Roadmap

What's shipped and what's coming next.

v0.1.0 Released 10 tools

Foundation - 12 skills, 6 rules, 10 read-only MCP tools.

v0.2.0 Released 20 tools

Container Lifecycle - 10 tools: run, create, start, stop, restart, kill, rm, pause, unpause, exec.

v0.3.0 Released 28 tools

Image and Build - 8 new tools: pull, push, build, tag, rmi, commit, save, load.

v0.4.0 Released 36 tools

Compose - 8 tools: up, down, ps, logs, build, restart, pull, exec. Published to npm.

v0.5.0 Released 49 tools

Volumes, Networks, Cleanup - 13 tools: volume/network CRUD, system/container/image prune.

v0.6.0 Released 55 tools

Advanced and Observability - 6 tools: cp, stats, top, events, update, wait.

v0.7.0 Released 68 tools

Buildx, Manifests, and Registry - 13 tools: buildx build/inspect/use, manifest CRUD, builder prune.

v0.8.0 Released 84 tools

Compose Completeness - 16 tools: config, cp, create, events, images, kill, ls, pause/unpause, port, rm, run, scale, start, stop, top.

v0.9.0 Released 98 tools

Container/Image Gaps, Context, Auth - 14 tools: diff, export, port, rename, history, import, context management, registry login/logout.

v0.10.0 Released 122 tools

Swarm Orchestration - 24 tools: swarm init/join/leave, service CRUD and scaling, node management.

v0.11.0 Released 140 tools

Swarm Stacks, Configs, Secrets, Trust - 18 tools: stack deploy, config/secret CRUD, Docker Content Trust.

v0.12.0 Released 150 tools

Niche, Scout, Extras - 10 tools: version info, Scout CVEs/recommendations, compose watch, plugin management.

v1.0.0 Current 150 tools

Stable release - finalized APIs, enhanced error messages, comprehensive docs, workflow diagrams.