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
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):
{
"mcpServers": {
"docker-tools": {
"command": "node",
"args": ["D:/products/mcp-servers/mcp-docker-tools/dist/index.js"]
}
}
}
Usage with Claude Code
claude mcp add docker-tools node D:/products/mcp-servers/mcp-docker-tools/dist/index.js
Or add to .claude/settings.json:
{
"mcpServers": {
"docker-tools": {
"command": "node",
"args": ["D:/products/mcp-servers/mcp-docker-tools/dist/index.js"]
}
}
}
Tool Examples
List running containers
{ "tool": "docker_container_list" }
List all containers including stopped
{ "tool": "docker_container_list", "args": { "all": true, "format": "table" } }
List images filtered by name
{ "tool": "docker_image_list", "args": { "filter": "node" } }
Analyze a Dockerfile
{
"tool": "docker_dockerfile_analyze",
"args": {
"content": "FROM node:20\nCOPY . .\nRUN npm install\nCMD [\"node\", \"index.js\"]"
}
}
Analyze docker-compose.yml
{
"tool": "docker_compose_analyze",
"args": {
"content": "services:\n web:\n image: nginx\n ports:\n - 80:80"
}
}
Get container logs
{
"tool": "docker_container_logs",
"args": { "container": "my-app", "tail": 50, "filter": "error" }
}
License
MIT