mcp-server

@tmhs/docker-mcp

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.

Part of Docker Developer Tools - works with Cursor, Claude Code, and any MCP-compatible client.

Requirements

Node.js >= 20
Docker CLI (docker) available on PATH

Installation

npm install -g @tmhs/docker-mcp

Or run directly with npx:

npx @tmhs/docker-mcp

Cursor MCP Configuration

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "docker": {
      "command": "npx",
      "args": ["-y", "@tmhs/docker-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "docker": {
      "command": "docker-mcp"
    }
  }
}

Tools (150)

Read / Inspect (10)

Tool	Description
`docker_listContainers`	List running/all containers
`docker_inspectContainer`	Detailed container info
`docker_containerLogs`	Fetch container logs
`docker_listImages`	List local images
`docker_inspectImage`	Detailed image metadata
`docker_listVolumes`	List volumes
`docker_listNetworks`	List networks
`docker_systemInfo`	Docker system info
`docker_diskUsage`	Disk usage breakdown
`docker_searchHub`	Search Docker Hub

Container Lifecycle (10)

Tool	Description
`docker_run`	Create and start a container
`docker_create`	Create a container without starting
`docker_start`	Start a stopped container
`docker_stop`	Stop a running container
`docker_restart`	Restart a container
`docker_kill`	Send a signal to a container
`docker_rm`	Remove a container
`docker_pause`	Pause container processes
`docker_unpause`	Unpause a container
`docker_exec`	Execute a command in a container

Image and Build (8)

Tool	Description
`docker_pull`	Pull an image from a registry
`docker_push`	Push an image to a registry
`docker_build`	Build an image from a Dockerfile
`docker_tag`	Tag an image
`docker_rmi`	Remove images
`docker_commit`	Create image from container changes
`docker_save`	Save images to tar archive
`docker_load`	Load images from tar archive

Compose (24)

Tool	Description
`docker_composeUp`	Create and start Compose services
`docker_composeDown`	Stop and remove Compose services
`docker_composePs`	List Compose project containers
`docker_composeLogs`	View Compose service logs
`docker_composeBuild`	Build Compose service images
`docker_composeRestart`	Restart Compose services
`docker_composePull`	Pull Compose service images
`docker_composeExec`	Execute command in a Compose service
`docker_composeConfig`	Validate and render a Compose file
`docker_composeCp`	Copy files to/from a Compose service
`docker_composeCreate`	Create containers without starting
`docker_composeEvents`	Real-time Compose container events
`docker_composeImages`	List images used by services
`docker_composeKill`	Force stop service containers
`docker_composeLs`	List Compose projects
`docker_composePause`	Pause Compose services
`docker_composeUnpause`	Unpause Compose services
`docker_composePort`	Get public port for a binding
`docker_composeRm`	Remove stopped service containers
`docker_composeRun`	Run one-off command on a service
`docker_composeScale`	Scale services to replica count
`docker_composeStart`	Start existing service containers
`docker_composeStop`	Stop services without removing
`docker_composeTop`	Running processes per service

Volume Management (4)

Tool	Description
`docker_volumeCreate`	Create a named volume
`docker_volumeRm`	Remove volumes
`docker_volumeInspect`	Detailed volume info
`docker_volumePrune`	Remove unused volumes

Network Management (6)

Tool	Description
`docker_networkCreate`	Create a network
`docker_networkRm`	Remove networks
`docker_networkConnect`	Connect container to network
`docker_networkDisconnect`	Disconnect container from network
`docker_networkInspect`	Detailed network info
`docker_networkPrune`	Remove unused networks

Cleanup / Prune (3)

Tool	Description
`docker_systemPrune`	Remove unused containers, networks, images
`docker_containerPrune`	Remove stopped containers
`docker_imagePrune`	Remove unused images

Advanced / Observability (6)

Tool	Description
`docker_cp`	Copy files between container and host
`docker_stats`	Live resource usage statistics
`docker_top`	Running processes in a container
`docker_events`	Real-time Docker daemon events
`docker_update`	Update container resource config
`docker_wait`	Wait for container to stop

Buildx (8)

Tool	Description
`docker_buildxBuild`	Multi-platform builds with buildx
`docker_buildxLs`	List builder instances
`docker_buildxCreate`	Create a new builder instance
`docker_buildxRm`	Remove a builder instance
`docker_buildxInspect`	Inspect a builder instance
`docker_buildxUse`	Set the default builder
`docker_buildxImagetools`	Inspect or create manifest lists via buildx
`docker_builderPrune`	Remove build cache

Manifest (5)

Tool	Description
`docker_manifestCreate`	Create a manifest list for multi-arch images
`docker_manifestInspect`	Display a manifest or manifest list
`docker_manifestAnnotate`	Add platform info to a manifest entry
`docker_manifestPush`	Push a manifest list to a registry
`docker_manifestRm`	Remove local manifest lists

Container Gaps (4)

Tool	Description
`docker_diff`	Inspect filesystem changes in a container
`docker_export`	Export container filesystem as tar
`docker_port`	List port mappings for a container
`docker_rename`	Rename a container

Image Gaps (2)

Tool	Description
`docker_imageHistory`	Show layer history of an image
`docker_import`	Import tarball as filesystem image

Context Management (6)

Tool	Description
`docker_contextCreate`	Create a context for remote hosts
`docker_contextLs`	List available contexts
`docker_contextInspect`	Detailed context info
`docker_contextRm`	Remove contexts
`docker_contextUse`	Set active context
`docker_contextShow`	Print current context name

Registry Authentication (2)

Tool	Description
`docker_login`	Authenticate to a registry
`docker_logout`	Log out from a 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

Swarm Stacks (6)

Tool	Description
`docker_stackDeploy`	Deploy or update a stack
`docker_stackRm`	Remove stacks
`docker_stackLs`	List stacks
`docker_stackPs`	List tasks in a stack
`docker_stackServices`	List services in a stack
`docker_stackConfig`	Output merged stack config

Swarm Configs (4)

Tool	Description
`docker_configCreate`	Create a Swarm config
`docker_configInspect`	Inspect a config
`docker_configLs`	List configs
`docker_configRm`	Remove configs

Swarm Secrets (4)

Tool	Description
`docker_secretCreate`	Create a Swarm secret
`docker_secretInspect`	Inspect a secret (metadata only)
`docker_secretLs`	List secrets
`docker_secretRm`	Remove secrets

Docker Content Trust (4)

Tool	Description
`docker_trustInspect`	Inspect trust data for an image
`docker_trustSign`	Sign an image
`docker_trustRevoke`	Revoke trust for an image
`docker_trustKey`	Manage signing keys

Utility (2)

Tool	Description
`docker_version`	Show Docker client and server version information
`docker_composeVersion`	Show Docker Compose version information

Compose Extras (1)

Tool	Description
`docker_composeWatch`	Watch build context and auto-rebuild on file changes

Docker Scout (3)

Tool	Description
`docker_scoutQuickview`	Quick overview of image vulnerabilities
`docker_scoutCves`	List CVEs found in an image
`docker_scoutRecommendations`	Get base image update recommendations

Plugin Management (4)

Tool	Description
`docker_pluginLs`	List installed Docker plugins
`docker_pluginInstall`	Install a Docker plugin from a registry
`docker_pluginRm`	Remove one or more Docker plugins
`docker_pluginEnable`	Enable a disabled Docker plugin

Name		Name	Last commit message	Last commit date
parent directory ..
src		src
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

@tmhs/docker-mcp

Requirements

Installation

Cursor MCP Configuration

Tools (150)

Read / Inspect (10)

Container Lifecycle (10)

Image and Build (8)

Compose (24)

Volume Management (4)

Network Management (6)

Cleanup / Prune (3)

Advanced / Observability (6)

Buildx (8)

Manifest (5)

Container Gaps (4)

Image Gaps (2)

Context Management (6)

Registry Authentication (2)

Swarm Cluster (8)

Swarm Services (9)

Swarm Nodes (7)

Swarm Stacks (6)

Swarm Configs (4)

Swarm Secrets (4)

Docker Content Trust (4)

Utility (2)

Compose Extras (1)

Docker Scout (3)

Plugin Management (4)

License

FilesExpand file tree

mcp-server

Directory actions

More options

Directory actions

More options

Latest commit

History

mcp-server

Folders and files

parent directory

README.md

@tmhs/docker-mcp

Requirements

Installation

Cursor MCP Configuration

Tools (150)

Read / Inspect (10)

Container Lifecycle (10)

Image and Build (8)

Compose (24)

Volume Management (4)

Network Management (6)

Cleanup / Prune (3)

Advanced / Observability (6)

Buildx (8)

Manifest (5)

Container Gaps (4)

Image Gaps (2)

Context Management (6)

Registry Authentication (2)

Swarm Cluster (8)

Swarm Services (9)

Swarm Nodes (7)

Swarm Stacks (6)

Swarm Configs (4)

Swarm Secrets (4)

Docker Content Trust (4)

Utility (2)

Compose Extras (1)

Docker Scout (3)

Plugin Management (4)

License