The docker-mcp server enables Docker container and Compose stack management through Claude AI with these capabilities:
🚀 Create new standalone Docker containers with specified images, names, ports, and environment variables
📦 Deploy Docker Compose stacks by providing compose YAML and project name
🔍 Retrieve logs from specific Docker containers
📊 List all Docker containers to monitor their status
Enables container and Docker Compose stack management, including creation of standalone containers, deployment of compose stacks, retrieval of container logs, and listing of container status and information.
🐳 docker-mcp
A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless 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
Deploying a Docker Compose Stack
https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278
Analyzing Container Logs
https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934
🚀 Quickstart
To try this in Claude Desktop app, add this to your claude config files:
Installing via Smithery
To install Docker MCP for Claude Desktop automatically via Smithery:
Prerequisites
UV (package manager)
Python 3.12+
Docker Desktop or Docker Engine
Claude Desktop
Installation
Claude Desktop Configuration
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
🛠️ Development
Local Setup
Clone the repository:
Create and activate a virtual environment:
Install dependencies:
🔍 Debugging
Launch the MCP Inspector for debugging:
The Inspector will provide a URL to access the debugging interface.
📝 Available Tools
The server provides the following tools:
create-container
Creates a standalone Docker container
deploy-compose
Deploys a Docker Compose stack
get-logs
Retrieves logs from a specific container
list-containers
Lists all Docker containers
🚧 Current Limitations
No built-in environment variable support for containers
No volume management
No network management
No container health checks
No container restart policies
No container resource limits
🤝 Contributing
Fork the repository from docker-mcp
Create your feature branch
Commit your changes
Push to the branch
Open a Pull Request
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
✨ Authors
Alex Andru - Initial work | Core contributor - @QuantGeekDev
Ali Sadykov - Initial work | Core contributor - @md-archive
Made with ❤️
local-only server
The server can only run on the client's local machine because it depends on local resources.
A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol (MCP) server that lets you seamlessly use OpenAI's models right from Claude.Last updated -13768MIT License
- AsecurityFlicenseAqualityAllows Claude and other AI assistants to interact with Docker through the MCP protocol, enabling container and image management including listing, running, stopping, and pulling Docker resources.Last updated -6294
- -securityAlicense-qualityA Model Context Protocol server that provides tools for interacting with Docker images, containers, and registries, enabling AI assistants to search, analyze, and manage Docker resources through a standardized interface.Last updated -MIT License
- -securityFlicense-qualityAn All-in-One Model Context Protocol Server Package that integrates 14 MCP servers (including YouTube, GitHub, Figma, databases) into a single Docker container for use with Claude.Last updated -
Appeared in Searches
- Managing Docker Containers and Applications
- Information about Docker software and containerization
- A server for managing Minecraft Fabric modpacks using Claude
- A server that can run Docker Compose commands to manage containers
- How to retrieve information about a device using Microsoft Defender, Intune, and Jamf