docker-mcp

A Model Context Protocol (MCP) server for Docker operations, enabling container and compose stack management through Claude AI.

✨ Features

• 🚀 Container creation and instantiation
• 📦 Docker Compose stack deployment
• 🗄️ Container logs retrieval
• 🗂️ Container listing and status monitoring

🎭 Demos

Demonstrations showcasing Docker Compose stack deployment and container log analysis.

🚀 Quickstart

Integrate with Claude Desktop by adding the provided configuration to your Claude config file.

Installing via Smithery

Install Docker MCP for Claude Desktop automatically using Smithery:

npx @smithery/cli install docker-mcp --client claude

Prerequisites

• UV (package manager)
• Python 3.12+
• Docker Desktop or Docker Engine
• Claude Desktop

Installation

Configure the server in your Claude Desktop config file. Development and production configurations are provided.

⚙️ Development

Local Setup

1. Clone the repository.
2. Create and activate a virtual environment.
3. Install dependencies using uv sync.

🗄️ Debugging

Launch the MCP Inspector for debugging:

npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp

🧰 Available Tools

Provides tools for container creation, Docker Compose deployment, log retrieval, and container listing.

🚧 Current Limitations

Limitations include no built-in environment variable support, volume management, network management, health checks, restart policies, and resource limits.

🙋 Contributing

Contribute by forking the repository, creating a feature branch, committing changes, pushing to the branch, and opening a pull request.

📜 License

Licensed under the MIT License.

✨ Authors

• Alex Andru - Initial work | Core contributor - @QuantGeekDev
• Ali Sadykov - Initial work | Core contributor - @md-archive