MCP Docker Server Documentation

A local Model Context Protocol (MCP) server for Docker visibility and light lifecycle control.

Features

• 12 Docker tools for container inspection, reversible container lifecycle actions, image inspection, network listing, volume listing, and Docker version info
• stdio transport only for local MCP clients
• No destructive Docker operations exposed through MCP
• Type safety with Pydantic validation and mypy strict mode
• Small configuration surface focused on Docker connection, reversible-operation gating, and logging

Canonical Docs

• README.md - Overview, install flow, and exposed tools
• CONFIGURATION.md - Environment variable reference
• SECURITY.md - Security notes

Quick Start

codex mcp add docker -- uvx mcp-docker@latest

claude mcp add --transport stdio docker uvx mcp-docker@latest

Safety

Safe tools are read-only and always allowed. Moderate tools start, stop, or restart containers and are allowed by default.

SAFETY_ALLOW_MODERATE_OPERATIONS=false

This read-only mode leaves list, inspect, logs, stats, and version tools available while blocking start/stop/restart.

What’s Available

• Container: list, inspect, logs, stats, start, stop, restart
• Image: list, inspect
• Network: list
• Volume: list
• System: Docker version

For complete details, see README.md.

Support

• Issues: GitHub Issues
• MCP Documentation: modelcontextprotocol.io
• PyPI Download Stats: pypi.kopdog.com

---

Version: 2.0.0 Last Updated: 2026-06-06 Python: 3.11+ Docker: API version 1.41+