mcp-docker-tools

Docker management tools for AI agents, built on the Model Context Protocol.

Provides five tools for inspecting containers, images, Dockerfiles, and Compose configurations — all accessible to LLMs through MCP.

Tools

Tool	Description
`docker_container_list`	List running or all containers with status, ports, image, created time, and resource usage (CPU, memory, network/block I/O)
`docker_image_list`	List Docker images with size, tags, created date, and layer count
`docker_dockerfile_analyze`	Analyze a Dockerfile for best practices: multi-stage builds, non-root user, layer caching, image size, security
`docker_compose_analyze`	Analyze docker-compose.yml: services, ports, volumes, networks, health checks, dependencies, and improvement suggestions
`docker_container_logs`	Get container logs with tail, keyword filter, time range, and timestamp support

Prerequisites

Node.js >= 18
Docker CLI installed and accessible in PATH
Docker daemon running (for container/image tools)

Installation

bash

git clone <repo-url>
cd mcp-docker-tools
npm install
npm run build

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

config.json

{
  "mcpServers": {
    "docker-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-docker-tools/dist/index.js"]
    }
  }
}

Usage with Claude Code

Terminal

claude mcp add docker-tools node D:/products/mcp-servers/mcp-docker-tools/dist/index.js

Or add to .claude/settings.json:

config.json

{
  "mcpServers": {
    "docker-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-docker-tools/dist/index.js"]
    }
  }
}

Tool Examples

List running containers

config.json

{ "tool": "docker_container_list" }

List all containers including stopped

config.json

{ "tool": "docker_container_list", "args": { "all": true, "format": "table" } }

List images filtered by name

config.json

{ "tool": "docker_image_list", "args": { "filter": "node" } }

Analyze a Dockerfile

config.json

{
  "tool": "docker_dockerfile_analyze",
  "args": {
    "content": "FROM node:20\nCOPY . .\nRUN npm install\nCMD [\"node\", \"index.js\"]"
  }
}

Analyze docker-compose.yml

config.json

{
  "tool": "docker_compose_analyze",
  "args": {
    "content": "services:\n  web:\n    image: nginx\n    ports:\n      - 80:80"
  }
}

Get container logs

config.json

{
  "tool": "docker_container_logs",
  "args": { "container": "my-app", "tail": 50, "filter": "error" }
}

License

MIT