@supernova123/docker-mcp-server

The Docker MCP server designed for agents that need their containers to stay running.

Without this: Your agent deploys a container, it crashes at 3am, and nobody notices until the user complains. Compose stacks drift. Health checks are manual. Logs are scattered across terminals.

With this: Your agent checks health, watches for readiness, restarts crashed containers, and follows logs, all through a single MCP interface. Containers stay running because your agent knows how to keep them running.

Why This Server?

There are 11+ Docker MCP servers on npm. Most are stale, GPL-licensed, or only cover basic CRUD. This one is different:

	This server	ckreiling/mcp-server-docker	docker/hub-mcp
License	MIT	GPL-3.0	Apache-2.0
Last updated	Active	Jun 2025 (stale)	Active
Health checks	✅ HTTP/TCP/exec probes	❌	❌
Auto-restart	✅ set_restart_policy	❌	❌
Compose lifecycle	✅ up/down/ps/logs/restart	❌	❌
Log streaming	✅ tail + timestamp filter	Basic	Basic
Agent positioning	✅ Built for agents	Generic Docker	Registry API

Quick Start

One command to run:

npx @supernova123/docker-mcp-server

Claude Desktop / Cursor / VS Code Config

Add to your MCP settings:

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

Claude Code

claude mcp add docker -- npx -y @supernova123/docker-mcp-server

Tools

Container Lifecycle

Tool	Description
list_containers	List containers with filters (state, label, name)
inspect_container	Get detailed container config and state
start_container	Start a stopped container
stop_container	Stop a running container
restart_container	Restart a container
remove_container	Remove a container (with force option)
recreate_container	Stop, remove, and re-create a container with same config
run_container	Create + start a container in one call

Image Management

Tool	Description
list_images	List images with optional filters
pull_image	Pull an image from a registry
build_image	Build an image from a Dockerfile
remove_image	Remove an image

Docker Compose

Tool	Description
compose_up	Bring up a Compose stack
compose_down	Tear down a Compose stack
compose_ps	List service states
compose_logs	Tail Compose service logs
compose_restart	Restart Compose services

Health & Self-Healing

Tool	Description
check_health	Run a health probe (HTTP, TCP, exec)
watch_health	Poll health until healthy or timeout
set_restart_policy	Change restart policy on a running container

Logs & Observability

Tool	Description
stream_logs	Get container logs with tail/timestamp filtering
container_stats	CPU, memory, network, block I/O snapshot

Exec

Tool	Description
exec_in_container	Run a command inside a running container

Networks & Volumes

Tool	Description
list_networks	List Docker networks
list_volumes	List Docker volumes

Requirements

• Node.js 18+
• Docker daemon running locally (or remote via DOCKER_HOST)
• Docker socket accessible at /var/run/docker.sock

Security

• Read-only by default: all container and image tools read state; write operations (start/stop/remove) require explicit tool calls
• No API keys needed: connects to local Docker daemon via socket
• No network access: all operations are local Docker API calls
• MIT License: fully auditable

License

MIT