# docker-mcp

> MCP Server

Docker-mcp is a Model Context Protocol (MCP) server that uses Claude AI to manage Docker containers and compose stacks. It enables container creation, deployment, log retrieval, and status monitoring for

## Overview

- **Category:** System Tools
- **Language:** Python
- **Stars:** 498
- **Forks:** 18
- **Owner:** QuantGeekDev
- **GitHub:** https://github.com/QuantGeekDev/docker-mcp
- **Created:** 2024-12-04T22:53:04+00:00
- **Updated:** 2025-03-28T18:24:41+00:00
- **Source:** https://model-context-protocol.com/servers/docker-mcp-model-context-protocol-server

## Setup

## Setup

1.  To try this in Claude Desktop app, add the provided configuration to your claude config files.
2.  Install Docker MCP for Claude Desktop automatically via Smithery using the command: `npx @smithery/cli install docker-mcp --client claude`.
3.  Ensure you have the prerequisites: UV, Python 3.12+, Docker Desktop or Docker Engine, and Claude Desktop.
4.  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`).
5.  For local development, clone the repository: `git clone https://github.com/QuantGeekDev/docker-mcp.git` and `cd docker-mcp`.
6.  Create and activate a virtual environment: `python -m venv venv` and `source venv/bin/activate` (or `venv\Scripts\activate` on Windows).
7.  Install dependencies using `uv sync`.
8.  Launch the MCP Inspector for debugging: `npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp`.

## Tools

## Available Tools

1. Container creation and instantiation (Creates a standalone Docker container).
2. Docker Compose stack deployment (Deploys a Docker Compose stack).
3. Container logs retrieval (Retrieves logs from a specific container).
4. Container listing and status monitoring (Lists all Docker containers).