docker-mcp-server
friendlygeorge/docker-mcp-server
Docker MCP server designed for agents that need their containers to stay running. Health checks, auto-restart, Compose lifecycle, log streaming.
Instalação
npx convez-ai friendlygeorge/docker-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
@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