🐳 docker-mcp

What is 🐳 docker-mcp?

🐳 docker-mcp is a Model Context Protocol (MCP) server that enables Claude AI to manage Docker containers and Docker Compose stacks directly from the Claude Desktop interface. It is designed for developers who want to control their Docker environment using natural language commands through Claude.

How to use 🐳 docker-mcp?

Add the server configuration to your Claude Desktop config file (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json) using the command uvx docker-mcp. Alternatively, install it automatically via Smithery with npx @smithery/cli install docker-mcp --client claude. Prerequisites include UV package manager, Python 3.12+, Docker Desktop or Docker Engine, and Claude Desktop.

Key features of 🐳 docker-mcp

• Container creation and instantiation (create-container)
• Docker Compose stack deployment (deploy-compose)
• Container logs retrieval (get-logs)
• Container listing and status monitoring (list-containers)

Use cases of 🐳 docker-mcp

• Deploying a multi-service Docker Compose stack through a chat interface.
• Inspecting container logs to debug errors without leaving Claude.
• Creating and managing containers on-demand with natural language prompts.
• Listing all running containers and checking their status via conversation.

FAQ from 🐳 docker-mcp

What are the prerequisites for running 🐳 docker-mcp?

You need UV, Python 3.12+, Docker Desktop or Docker Engine, and Claude Desktop. The server is installed via uvx docker-mcp.

What are the current limitations of 🐳 docker-mcp?

The README lists several missing features: no built-in environment variable support, no volume or network management, no container health checks, no restart policies, and no resource limits.

How do I install 🐳 docker-mcp via Smithery?

Run npx @smithery/cli install docker-mcp --client claude in your terminal. This automatically configures the server for Claude Desktop.

What tools does 🐳 docker-mcp provide?

It offers four tools: create-container, deploy-compose, get-logs, and list-containers. Each tool accepts specific JSON parameters as shown in the README.

Does 🐳 docker-mcp support authentication?

No. The server connects to your local Docker daemon and does not include any authentication mechanism. It relies on the user's local Docker setup.