convez.ai
MCP Server
friendlygeorge

docker-mcp-server

friendlygeorge/docker-mcp-server

Ver no GitHub
InicialPluginScore · de 0 a 100

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-server

1 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

Estrelas
4
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v0.4.0
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

@supernova123/docker-mcp-server

npm version npm downloads License: MIT MCP Claude Desktop

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 serverckreiling/mcp-server-dockerdocker/hub-mcp
LicenseMITGPL-3.0Apache-2.0
Last updatedActiveJun 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 filterBasicBasic
Agent positioning✅ Built for agentsGeneric DockerRegistry 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

ToolDescription
list_containersList containers with filters (state, label, name)
inspect_containerGet detailed container config and state
start_containerStart a stopped container
stop_containerStop a running container
restart_containerRestart a container
remove_containerRemove a container (with force option)
recreate_containerStop, remove, and re-create a container with same config
run_containerCreate + start a container in one call

Image Management

ToolDescription
list_imagesList images with optional filters
pull_imagePull an image from a registry
build_imageBuild an image from a Dockerfile
remove_imageRemove an image

Docker Compose

ToolDescription
compose_upBring up a Compose stack
compose_downTear down a Compose stack
compose_psList service states
compose_logsTail Compose service logs
compose_restartRestart Compose services

Health & Self-Healing

ToolDescription
check_healthRun a health probe (HTTP, TCP, exec)
watch_healthPoll health until healthy or timeout
set_restart_policyChange restart policy on a running container

Logs & Observability

ToolDescription
stream_logsGet container logs with tail/timestamp filtering
container_statsCPU, memory, network, block I/O snapshot

Exec

ToolDescription
exec_in_containerRun a command inside a running container

Networks & Volumes

ToolDescription
list_networksList Docker networks
list_volumesList 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

Ver o original no GitHub

Bom para

Relacionados