@rog0x/mcp-docker-tools

Name: @rog0x/mcp-docker-tools
Author: rog0x

@rog0x

About @rog0x/mcp-docker-tools

MCP server for Docker: list containers/images, analyze Dockerfiles and docker-compose, view container logs Install: npx @rog0x/mcp-docker-tools

Basic information

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

List running or all containers with status, ports, image, created time, and resource usage (CPU, memory, network/block I/O)

List Docker images with size, tags, created date, and layer count

Analyze a Dockerfile for best practices: multi-stage builds, non-root user, layer caching, image size, security

Analyze docker-compose.yml: services, ports, volumes, networks, health checks, dependencies, and improvement suggestions

Get container logs with tail, keyword filter, time range, and timestamp support

Overview

What is @rog0x/mcp-docker-tools?

@rog0x/mcp-docker-tools is a Model Context Protocol server that gives AI agents five tools for inspecting and analyzing Docker containers, images, Dockerfiles, and Compose configurations. It is designed for developers and operations teams who want LLMs to directly interact with their Docker environments.

How to use @rog0x/mcp-docker-tools?

Install Node.js >= 18 and ensure the Docker CLI is accessible in PATH. Clone the repository, run npm install and npm run build, then add the server to your MCP client configuration (e.g., claude_desktop_config.json for Claude Desktop or .claude/settings.json for Claude Code) with the command node and the path to dist/index.js. The five tools are then available to the LLM.

Key features of @rog0x/mcp-docker-tools

List running or all containers with resource usage details
List Docker images with size, tags, and layer count
Analyze a Dockerfile for best practices and security
Analyze docker-compose.yml for services, networks, and improvements
Retrieve container logs with tail, filter, and timestamp options

Use cases of @rog0x/mcp-docker-tools

An AI assistant troubleshooting a running container by reading its logs
An LLM reviewing a Dockerfile for security and efficiency improvements
Automating container inventory and image audit reports
Validating docker-compose configurations before deployment
Helping developers debug container issues via natural language queries

FAQ from @rog0x/mcp-docker-tools

What are the prerequisites for @rog0x/mcp-docker-tools?

Node.js >= 18 and a Docker CLI installed in your system PATH are required. The Docker daemon must be running for tools that interact with containers and images.

How do I install and configure @rog0x/mcp-docker-tools?

Clone the repository, run npm install and npm run build. Then add the server to your MCP client configuration (e.g., Claude Desktop or Claude Code) using the command node and the path to the built dist/index.js file.

Does @rog0x/mcp-docker-tools require a running Docker daemon?

Yes. Tools such as docker_container_list, docker_image_list, and docker_container_logs rely on the Docker daemon being active. The docker_dockerfile_analyze and docker_compose_analyze tools work by analyzing provided file content and do not need the daemon.