Manage Docker containers, images, networks, and volumes via mcp-server-docker (uvx/Python) — 19 tools

{
  "server": "mcp-server-docker",
  "version": "0.2.1",
  "install": "uv pip install mcp-server-docker (Python 3.12+)",
  "launch": "DOCKER_HOST=unix://$HOME/.docker/run/docker.sock mcp-server-docker",
  "transport": "stdio",
  "tools_count": 19,
  "test_calls": 22,
  "success_rate": "91% (20/22 — 2 correct 404 rejections)",
  "p50_ms": 16,
  "max_ms": 1132,
  "calls": [
    {
      "tool": "list_containers",
      "args": {
        "all": true
      },
      "ok": true,
      "ms": 155,
      "result": "1 running container (mcp/brave-search)"
    },
    {
      "tool": "list_containers",
      "args": {
        "all": false
      },
      "ok": true,
      "ms": 16
    },
    {
      "tool": "list_images",
      "args": {},
      "ok": true,
      "ms": 153,
      "result": "multiple images including alpine, loanword-sandbox, mcp/brave-search"
    },
    {
      "tool": "list_networks",
      "args": {},
      "ok": true,
      "ms": 6,
      "result": "compose networks + default bridge/host/none"
    },
    {
      "tool": "list_volumes",
      "args": {},
      "ok": true,
      "ms": 14
    },
    {
      "tool": "run_container",
      "args": {
        "image": "alpine:latest",
        "name": "pathfinder-test-1",
        "command": "echo Hello from pathfinder test!",
        "auto_remove": true
      },
      "ok": true,
      "ms": 437,
      "result": "container ran and auto-removed"
    },
    {
      "tool": "run_container",
      "args": {
        "image": "alpine:latest",
        "name": "pathfinder-test-2",
        "command": "sleep 30",
        "detach": true,
        "labels": {
          "test": "pathfinder"
        }
      },
      "ok": true,
      "ms": 159,
      "result": "container started detached"
    },
    {
      "tool": "list_containers",
      "args": {
        "all": true,
        "filters": {
          "name": ["pathfinder-test"]
        }
      },
      "ok": true,
      "ms": 8,
      "note": "filter returned empty — may need exact name match"
    },
    {
      "tool": "fetch_container_logs",
      "args": {
        "container_id": "pathfinder-test-2",
        "tail": 10
      },
      "ok": true,
      "ms": 10,
      "result": "empty logs (sleep produces no output)"
    },
    {
      "tool": "stop_container",
      "args": {
        "container_id": "pathfinder-test-2"
      },
      "ok": true,
      "ms": 1132,
      "note": "10s SIGTERM grace period"
    },
    {
      "tool": "remove_container",
      "args": {
        "container_id": "pathfinder-test-2"
      },
      "ok": true,
      "ms": 18
    },
    {
      "tool": "list_containers",
      "args": {
        "all": true,
        "filters": {
          "label": ["test=pathfinder"]
        }
      },
      "ok": true,
      "ms": 7,
      "result": "empty (container removed)"
    },
    {
      "tool": "create_volume",
      "args": {
        "name": "pathfinder-test-vol",
        "labels": {
          "test": "pathfinder"
        }
      },
      "ok": true,
      "ms": 8,
      "result": {
        "name": "pathfinder-test-vol",
        "driver": "local"
      }
    },
    {
      "tool": "list_volumes",
      "args": {},
      "ok": true,
      "ms": 2,
      "note": "volume confirmed in list"
    },
    {
      "tool": "remove_volume",
      "args": {
        "volume_name": "pathfinder-test-vol"
      },
      "ok": true,
      "ms": 6
    },
    {
      "tool": "create_network",
      "args": {
        "name": "pathfinder-test-net",
        "driver": "bridge",
        "labels": {
          "test": "pathfinder"
        }
      },
      "ok": true,
      "ms": 39
    },
    {
      "tool": "list_networks",
      "args": {},
      "ok": true,
      "ms": 7,
      "note": "network confirmed in list"
    },
    {
      "tool": "remove_network",
      "args": {
        "network_id": "pathfinder-test-net"
      },
      "ok": true,
      "ms": 194
    },
    {
      "tool": "list_images",
      "args": {
        "name": "alpine"
      },
      "ok": true,
      "ms": 11,
      "result": "alpine:latest filtered"
    },
    {
      "tool": "run_container",
      "args": {
        "image": "alpine:latest",
        "name": "pathfinder-test-3",
        "command": "env",
        "environment": {
          "MY_VAR": "hello_from_pathfinder",
          "ANOTHER": "42"
        },
        "auto_remove": true
      },
      "ok": true,
      "ms": 201,
      "result": "env vars injected"
    },
    {
      "tool": "remove_container",
      "args": {
        "container_id": "nonexistent-container-xyz"
      },
      "ok": false,
      "ms": 9,
      "error": "404 No such container (correct rejection)"
    },
    {
      "tool": "fetch_container_logs",
      "args": {
        "container_id": "nonexistent-xyz"
      },
      "ok": false,
      "ms": 4,
      "error": "404 No such container (correct rejection)"
    }
  ],
  "env": {
    "DOCKER_HOST": "unix://$HOME/.docker/run/docker.sock"
  },
  "gotcha_macos": "Docker Desktop uses ~/.docker/run/docker.sock, not /var/run/docker.sock",
  "gotcha_python": "Requires Python 3.12+",
  "gotcha_no_exec": "No exec tool — can only run new containers or read logs"
}