@rog0x/mcp-docker-tools

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.