# io.github.Dave-London/docker (npm · @paretools/docker)

Structured Docker operations (ps, images, logs, build) as typed JSON.

- Trust score: 80/100 (high trust)
- Change this week: −12
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@paretools/docker`: 80/100 (this document), [markdown](https://verifymcp.io/servers/dave-london-docker/paretools-docker.md), [page](https://verifymcp.io/servers/dave-london-docker/paretools-docker)

## Channel facts

- Registry: `npm`
- Package: `@paretools/docker`
- Version: `0.8.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to Dave-London/Pare).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 4 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 76/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1485 tokens (~114/item across 13 items; 13 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add dave-london-docker -- npx -y @paretools/docker
```

### Codex

```bash
codex mcp add dave-london-docker -- npx -y @paretools/docker
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dave-london-docker": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@paretools/docker"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add dave-london-docker --command npx --arg -y --arg @paretools/docker
```

### Hermes

```yaml
mcp_servers:
  dave-london-docker:
    command: "npx"
    args: ["-y", "@paretools/docker"]
```

### Other

```json
{
  "mcpServers": {
    "dave-london-docker": {
      "command": "npx",
      "args": [
        "-y",
        "@paretools/docker"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 79, +44)

- [security improvement] Known CVEs: unverified → partial
- [security improvement] Provenance: unverified → pass
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] The attested source repository moved: Dave-London/Pare
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] License: unverified → pass
- [functional] Licence: MIT

### 2026-07-31 (score 35, −5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 40, −52)

- [security regression] Known CVEs: partial → unverified
- [security regression] Provenance: pass → unverified
- [security regression] Install scripts: pass → unverified
- [security regression] Malware scan: pass → unverified
- [security] The attested source repository moved: Dave-London/Pare
- [functional regression] Maintenance: pass → unverified
- [functional regression] Dependency health: partial → unverified
- [functional regression] License: pass → unverified
- [functional] Licence: MIT

### 2026-07-27 (score 92, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 91)

First indexed and scored.

## MCP tools (13)

### `ps` (~74 tokens)

Docker PS

Lists Docker containers with structured status, ports, and state information. Use instead of running `docker ps` in the terminal.

Input parameters:

- `all` (boolean): Show all containers (default: true, includes stopped)
- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.

Output parameters:

- `containers` (array)
- `running` (number)
- `stopped` (number)
- `total` (number)

### `build` (~118 tokens)

Docker Build

Builds a Docker image and returns structured build results including image ID, duration, and errors. Use instead of running `docker build` in the terminal.

Input parameters:

- `args` (array): Additional build arguments
- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `file` (string): Dockerfile path (default: Dockerfile)
- `path` (string): Build context path (default: cwd)
- `tag` (string): Image tag (e.g., myapp:latest)

Output parameters:

- `duration` (number)
- `errors` (array)
- `imageId` (string)
- `steps` (number)
- `success` (boolean)

### `logs` (~134 tokens)

Docker Logs

Retrieves container logs as structured line arrays. Use instead of running `docker logs` in the terminal.

Input parameters:

- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `container` (string, required): Container name or ID
- `limit` (number): Max lines in structured output (default: 100). Lines beyond this are truncated with isTruncated flag.
- `since` (string): Show logs since timestamp (e.g., '10m', '2024-01-01')
- `tail` (number): Number of lines to return (default: 100)

Output parameters:

- `container` (string)
- `isTruncated` (boolean)
- `lines` (array)
- `total` (number)
- `totalLines` (number)

### `images` (~94 tokens)

Docker Images

Lists Docker images with structured repository, tag, size, and creation info. Use instead of running `docker images` in the terminal.

Input parameters:

- `all` (boolean): Show all images including intermediates
- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `filter` (string): Filter by reference (e.g., 'myapp', 'nginx:*')

Output parameters:

- `images` (array)
- `total` (number)

### `run` (~202 tokens)

Docker Run

Runs a Docker container from an image and returns structured container ID and status. Use instead of running `docker run` in the terminal.

Input parameters:

- `command` (array): Command to run in the container
- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `detach` (boolean): Run container in background (default: true)
- `env` (array): Environment variables (e.g., ["KEY=VALUE"])
- `image` (string, required): Docker image to run (e.g., nginx:latest)
- `name` (string): Container name
- `path` (string): Working directory (default: cwd)
- `ports` (array): Port mappings (e.g., ["8080:80", "443:443"])
- `rm` (boolean): Remove container after exit (default: false)
- `volumes` (array): Volume mounts (e.g., ["/host/path:/container/path"])

Output parameters:

- `containerId` (string)
- `detached` (boolean)
- `image` (string)
- `name` (string)

### `exec` (~147 tokens)

Docker Exec

Executes arbitrary commands inside a running Docker container and returns structured output. Use instead of running `docker exec` in the terminal. WARNING: This runs arbitrary commands inside the container. Only use on trusted containers.

Input parameters:

- `command` (array, required): Command to execute (e.g., ["ls", "-la"])
- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `container` (string, required): Container name or ID
- `env` (array): Environment variables (e.g., ["KEY=VALUE"])
- `path` (string): Host working directory (default: cwd)
- `workdir` (string): Working directory inside the container

Output parameters:

- `exitCode` (number)
- `stderr` (string)
- `stdout` (string)
- `success` (boolean)

### `compose-up` (~127 tokens)

Docker Compose Up

Starts Docker Compose services and returns structured status. Use instead of running `docker compose up` in the terminal.

Input parameters:

- `build` (boolean): Build images before starting (default: false)
- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `detach` (boolean): Run in background (default: true)
- `file` (string): Compose file path (default: docker-compose.yml)
- `path` (string, required): Directory containing docker-compose.yml
- `services` (array): Specific services to start (default: all)

Output parameters:

- `services` (array)
- `started` (number)
- `success` (boolean)

### `compose-down` (~114 tokens)

Docker Compose Down

Stops Docker Compose services and returns structured status. Use instead of running `docker compose down` in the terminal.

Input parameters:

- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `file` (string): Compose file path (default: docker-compose.yml)
- `path` (string, required): Directory containing docker-compose.yml
- `removeOrphans` (boolean): Remove orphan containers (default: false)
- `volumes` (boolean): Also remove named volumes (default: false)

Output parameters:

- `removed` (number)
- `stopped` (number)
- `success` (boolean)

### `pull` (~120 tokens)

Docker Pull

Pulls a Docker image from a registry and returns structured result with digest info. Use instead of running `docker pull` in the terminal.

Input parameters:

- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `image` (string, required): Image to pull (e.g., nginx:latest, ubuntu:22.04)
- `path` (string): Working directory (default: cwd)
- `platform` (string): Target platform (e.g., "linux/amd64", "linux/arm64")

Output parameters:

- `digest` (string)
- `image` (string)
- `success` (boolean)
- `tag` (string)

### `inspect` (~88 tokens)

Docker Inspect

Shows detailed container or image information with structured state, image, and platform data. Use instead of running `docker inspect` in the terminal.

Input parameters:

- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `path` (string): Working directory (default: cwd)
- `target` (string, required): Container or image name/ID to inspect

Output parameters:

- `created` (string)
- `id` (string)
- `image` (string)
- `name` (string)
- `platform` (string)
- `state` (object)

### `network-ls` (~70 tokens)

Docker Network LS

Lists Docker networks with structured driver and scope information. Use instead of running `docker network ls` in the terminal.

Input parameters:

- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `path` (string): Working directory (default: cwd)

Output parameters:

- `networks` (array)
- `total` (number)

### `volume-ls` (~74 tokens)

Docker Volume LS

Lists Docker volumes with structured driver, mountpoint, and scope information. Use instead of running `docker volume ls` in the terminal.

Input parameters:

- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `path` (string): Working directory (default: cwd)

Output parameters:

- `total` (number)
- `volumes` (array)

### `compose-ps` (~74 tokens)

Docker Compose PS

Lists Docker Compose services with structured state and status information. Use instead of running `docker compose ps` in the terminal.

Input parameters:

- `compact` (boolean): Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema.
- `path` (string): Directory containing docker-compose.yml (default: cwd)

Output parameters:

- `services` (array)
- `total` (number)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/dave-london-docker/paretools-docker#diagnostics

## Score history

- 2026-08-03: 80
- 2026-08-02: 79
- 2026-08-01: 35
- 2026-07-31: 35
- 2026-07-30: 40
- 2026-07-28: 92
- 2026-07-27: 92
- 2026-07-26: 91

## Links

- npm package: https://www.npmjs.com/package/@paretools/docker
- Socket report: https://socket.dev/npm/package/@paretools/docker
- Repository: https://github.com/Dave-London/Pare
- Changelog RSS feed: https://verifymcp.io/servers/dave-london-docker/paretools-docker/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/dave-london-docker/paretools-docker/changelog.json
- HTML version of this page: https://verifymcp.io/servers/dave-london-docker/paretools-docker