Skip to main content
Glama

DockerBro

DockerBro is a proper MCP-compliant Docker management server. Speaks JSON-RPC 2.0 over stdin/stdout and talks to your local Docker daemon.

Works with Zed, Claude, Cursor, VS Code, and any other MCP-compatible AI editor.

Runs on macOS, Linux, and Windows.

pip install dockerbro

Features

Tool

What it does

Safety

list_containers

List all containers with status, image, ports

Read-only

inspect_container

Detailed container info (network, mounts, env)

Read-only

start_container

Start a stopped container

Reversible

stop_container

Stop a running container

Reversible

restart_container

Restart a container

Reversible

remove_container

Remove a container (with optional force)

⚠️ Destructive

logs_container

Get recent log output

Read-only

exec_container

Run a command inside a running container

⚠️ Destructive

list_images

List local Docker images

Read-only

pull_image

Pull an image from a registry

Reversible

run_container

Run a new container with ports, env, etc.

Reversible

remove_image

Remove a local image

⚠️ Destructive

docker_compose_ps

List Compose services

Read-only

docker_compose_up

Start Compose services

Reversible

docker_compose_down

Stop and remove Compose services

⚠️ Destructive

docker_compose_logs

Get Compose service logs

Read-only


Related MCP server: Docker MCP Server

Pre-approving tools

Each tool is annotated with MCP spec annotations (readOnlyHint, destructiveHint, idempotentHint) so spec-aware clients (Claude Code, Cursor, etc.) can auto-approve read-only tools without prompting.

You can also restrict tools at the server level via environment variables, enforced before anything reaches the client:

Env var

Effect

DOCKER_MCP_ALLOW_TOOLS

Comma-separated allowlist — only these tools are exposed and callable

DOCKER_MCP_DENY_TOOLS

Comma-separated denylist — always blocked (deny wins over allow)

Example: only safe read-only tools

Pass the env var in your Zed config (add to the env object):

"env": {
  "DOCKER_MCP_ALLOW_TOOLS": "list_containers,inspect_container,logs_container,list_images,docker_compose_ps,docker_compose_logs"
}

If a tool is not pre-approved, the server returns an error:

Tool 'remove_container' is not pre-approved (blocked by server allow/deny config).

Note: Client-side approval (e.g. Zed's agent.tool_permissions) and server-side pre-approval are independent. The server-side list controls which tools are visible and callable at all; the client controls which of those require a confirmation prompt.


Requirements

  • Python 3.9+

  • Docker installed and running


Install

Platform

Command

macOS / Linux

pip3 install dockerbro

Windows

pip install dockerbro

Any (if pip isn't on PATH)

python3 -m pip install dockerbro

command not found: pip? On macOS and many Linux distros, Python 3 installs it as pip3. On Windows it's usually pip or py -m pip. When in doubt, python3 -m pip install dockerbro works everywhere.

This puts a dockerbro command on your PATH, so your editor config needs no file paths at all.

Verify it works:

dockerbro --version 2>/dev/null; echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | dockerbro

Option B: Run from source

git clone https://github.com/ramanailearning-cpu/dockerbro.git
cd dockerbro
pip install -e .

Option C: Run in a Docker container

Build it:

docker build -t dockerbro .

Run it — the socket mount differs per platform:

macOS / Linux:

docker run --rm -i -v /var/run/docker.sock:/var/run/docker.sock dockerbro

Windows (PowerShell):

docker run --rm -i -v //./pipe/docker_engine://./pipe/docker_engine dockerbro

Connecting to the Docker daemon

DockerBro auto-detects your daemon, so this usually needs zero configuration:

Platform

Default endpoint

Linux

/var/run/docker.sock

macOS (Docker Desktop)

/var/run/docker.sock, or ~/.docker/run/docker.sock on 4.13+

Windows

Named pipe //./pipe/docker_engine

To point at a different or remote daemon, set DOCKER_HOST in your config's env block:

"env": { "DOCKER_HOST": "tcp://192.168.1.50:2375" }

macOS Docker Desktop note: if you get a connection error, enable Settings → Advanced → Allow the default Docker socket, or set DOCKER_HOST to unix:///Users/YOUR_NAME/.docker/run/docker.sock.


Zed Configuration

Add this to your Zed settings file (Cmd-Shift-P → Open Settings on macOS, Ctrl-Shift-P on Linux/Windows):

"context_servers": {
  "dockerbro": {
    "command": "dockerbro",
    "env": {
      "DOCKER_MCP_LOG": "/tmp/dockerbro.log"
    }
  }
}

Restricting tools server-side

Optionally, add env vars to limit which tools are exposed:

"env": {
  "DOCKER_MCP_LOG": "/tmp/dockerbro.log",
  "DOCKER_MCP_DENY_TOOLS": "remove_container,remove_image,exec_container,docker_compose_down"
}

Reload Zed (Cmd-Shift-P on macOS / Ctrl-Shift-P on Linux or Windows → Reload Window). The agent will have 16 Docker tools available.

Windows note: If the dockerbro command isn't found by Zed, use the full path shown by where dockerbro in your terminal.


Claude Desktop Configuration

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dockerbro": {
      "command": "dockerbro",
      "env": {
        "DOCKER_MCP_LOG": "/tmp/dockerbro.log"
      }
    }
  }
}

Linux

Edit ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dockerbro": {
      "command": "dockerbro",
      "env": {
        "DOCKER_MCP_LOG": "/tmp/dockerbro.log"
      }
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json (paste the path into Explorer's address bar):

{
  "mcpServers": {
    "dockerbro": {
      "command": "dockerbro",
      "env": {
        "DOCKER_MCP_LOG": "C:\\Users\\YOU\\dockerbro.log"
      }
    }
  }
}

Testing

Via terminal (pipe JSON-RPC)

# Initialize
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | dockerbro

# List tools
echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | dockerbro

# Call a tool
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_containers","arguments":{"all":true}}}' | dockerbro

Via MCP Inspector

npx @modelcontextprotocol/inspector dockerbro

Architecture

AI Editor (Zed / Claude / Cursor / VS Code)
    |  (stdin/stdout: JSON-RPC 2.0)
    v
dockerbro  (Python)
    |  (Docker SDK)
    v
Docker Daemon

License

MIT

Available Tools

16 tools
docker_compose_downA
DestructiveIdempotent

Stop and remove Docker Compose services.

Inputs: volumes, project_dir.

docker_compose_logsC
Read-only

Get Docker Compose service logs.

Inputs: tail, service, project_dir.

docker_compose_psB
Read-only

List Docker Compose services.

Inputs: project_dir.

docker_compose_upB
Idempotent

Start Docker Compose services.

Inputs: build, detach, services, project_dir.

exec_containerB

Execute a command inside a running container.

Inputs: command (required), container (required).

inspect_containerC
Read-only

Get detailed info about a container.

Inputs: container (required).

list_containersA
Read-only

List Docker containers with status, image, ports.

Inputs: all.

list_imagesA
Read-only

List Docker images on the local system.

Inputs: no named parameters.

logs_containerB
Read-only

Get recent log output from a container.

Inputs: container (required), tail.

pull_imageB
Idempotent

Pull a Docker image from a registry.

Inputs: image (required).

remove_containerA
Destructive

Remove a stopped container. Pass force=true for running containers.

Inputs: container (required), force.

remove_imageB
Destructive

Remove a Docker image.

Inputs: image (required).

restart_containerC
Idempotent

Restart a container.

Inputs: container (required).

run_containerB
Idempotent

Run a new container from an image.

Inputs: image (required), env, name, ports, +2 more.

start_containerA
Idempotent

Start a stopped container.

Inputs: container (required).

stop_containerC
Idempotent

Stop a running container.

Inputs: container (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 16 tools

    Disambiguation5/5

    Each tool targets a distinct Docker resource and action. Container management tools (list, inspect, start, stop, restart, remove, logs, exec, run) are clearly separated from image tools (list, pull, remove) and compose tools (up, down, logs, ps). No two tools have overlapping purposes.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (e.g., list_containers, start_container, remove_image). The Docker Compose tools consistently use a docker_compose_ prefix with a verb suffix, which is a slight deviation from the main pattern but remains predictable and internally consistent.

    Tool Count5/5

    With 16 tools, the server is well-scoped for Docker management. Each tool covers a distinct operation, and the count is appropriate for handling containers, images, and Compose workflows without being overwhelming or sparse.

    Completeness4/5

    The tool set covers the core Docker lifecycle: container run/start/stop/restart/remove/logs/exec, image list/pull/remove, and Compose up/down/logs/ps. Missing operations like image build/push or container stats are notable but not critical for common workflows, allowing agents to work around the gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that allows managing Docker containers through natural language, enabling users to compose, introspect, and debug containers without running commands themselves.
      3,210 PyPI
      758
      GPL 3.0
    • F
      license
      B
      quality
      C
      maintenance
      An MCP server that enables managing Docker containers through natural language commands, allowing users to create, list, and delete containers. It facilitates automated container orchestration and integrates with VS Code via the Cline extension.
      3
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Dockerized MCP server that enables Discord integration, offering tools for role management, messaging, moderation, and server administration via natural language.
      1
      MIT